IUrlAccessor::GetSecurityDescriptor-Methode (searchapi.h)
Ruft die Sicherheitsbeschreibung für das URL-Element ab. Die Sicherheit wird zur Abfragezeit angewendet, sodass dieser Deskriptor die Sicherheit für den Lesezugriff identifiziert.
Syntax
HRESULT GetSecurityDescriptor(
[out] BYTE *pSD,
[in] DWORD dwSize,
[out] DWORD *pdwLength
);
Parameter
[out] pSD
Typ: BYTE*
Empfängt einen Zeiger auf die Sicherheitsbeschreibung.
[in] dwSize
Art: DWORD
Größe in TCHARs des pSD-Arrays .
[out] pdwLength
Typ: DWORD*
Empfängt einen Zeiger auf die Anzahl von TCHAR-Werten, die in pSD geschrieben wurden, ohne den beendenden NULL-Wert.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Methode ermöglicht benutzerdefinierte Zuordnungen zwischen Benutzern, die für eine Inhaltsquelle registriert sind, und den benutzern, die in der Domäne registriert sind, sofern sie sich unterscheiden. In dieser Methode erstellte Sicherheitsbeschreibungen müssen selbstrelativ sein.
Wenn die URL eine Benutzersicherheits-ID (SID) enthält, wird der Protokollhandler im Sicherheitskontext dieses Benutzers aufgerufen, und diese Methode muss E_NOTIMPL zurückgeben.
Wenn die URL keine Benutzer-SID enthält, wird der Protokollhandler im Sicherheitskontext des Systemdiensts aufgerufen. In diesem Fall kann diese Methode entweder eine Zugriffssteuerungsliste (Access Control List, ACL) zurückgeben, um den Lesezugriff einzuschränken, oder PRTH_S_ACL_IS_READ_EVERYONE , jedem Lesezugriff während der Abfrage zu ermöglichen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2, Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | searchapi.h |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |