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

Weitere Informationen

IUrlAccessor

Suchprotokollhandlerfehlermeldungen