Freigeben über

IUrlAccessor::GetSecurityDescriptor-Methode (searchapi.h)

  • Artikel

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.

Hinweis Wenn diese Methode E_NOTIMPL zurückgibt und die URL KEINE Benutzer-SID enthält, kann das Element von allen Benutzerabfragen abgerufen werden.
 

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

Weitere Informationen

IUrlAccessor

Suchprotokollhandlerfehlermeldungen