IWSDScopeMatchingRule::GetScopeRule-Methode (wsddisco.h)
Wird aufgerufen, um einen URI zurückzugeben, der die implementierte Bereichsabgleichsregel definiert.
Syntax
HRESULT GetScopeRule(
[out] LPCWSTR *ppszScopeMatchingRule
);
Parameter
[out] ppszScopeMatchingRule
Zeiger auf die Bereichsabgleichsregel. Der Implementierer muss Arbeitsspeicher mithilfe von WSDAllocateLinkedMemory zuordnen, und der Aufrufer muss Arbeitsspeicher mithilfe von WSDFreeLinkedMemory freigeben.
Rückgabewert
Mögliche Rückgabewerte sind unter anderem:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
Hinweise
GetScopeRule sollte eine Kopie des URI für die Bereichsabgleichsregel bereitstellen, die dieses Objekt darstellt. Die Kopie wird vom Aufrufer mithilfe von WSDFreeLinkedMemory freigegeben.
ppszScopeMatchingRule darf niemalsNULL oder eine leere Zeichenfolge sein. Um sich für die Übereinstimmungsregel für den NULL-Bereich zu registrieren, registrieren Sie sich für die RFC2396 Regel, wie in WS-Discovery definiert. Testmeldungen, die einen NULL MatchBy-Wert enthalten, werden in RFC2396 konvertiert, bevor GetScopeRule aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wsddisco.h (einschließen von Wsdapi.h) |
| DLL | Wsdapi.dll |