Metodo IUrlAccessor::GetSecurityDescriptor (searchapi.h)

Ottiene il descrittore di sicurezza per l'elemento URL. La sicurezza viene applicata in fase di query, quindi questo descrittore identifica la sicurezza per l'accesso in lettura.

Sintassi

HRESULT GetSecurityDescriptor(
  [out] BYTE  *pSD,
  [in]  DWORD dwSize,
  [out] DWORD *pdwLength
);

Parametri

[out] pSD

Tipo: BYTE*

Riceve un puntatore al descrittore di sicurezza.

[in] dwSize

Tipo: DWORD

Dimensioni in TCHARs della matrice pSD .

[out] pdwLength

Tipo: DWORD*

Riceve un puntatore al numero di TCHARs scritti in pSD, senza includere il valore NULL di terminazione.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo consente mapping personalizzati tra gli utenti registrati in un'origine contenuto e gli utenti registrati nel dominio, se sono diversi. I descrittori di sicurezza creati in questo metodo devono essere auto-relativi.

Se l'URL contiene un SID (User Security Identifier), il gestore del protocollo viene richiamato nel contesto di sicurezza dell'utente e questo metodo deve restituire E_NOTIMPL.

Se l'URL non contiene un SID utente, il gestore del protocollo viene richiamato nel contesto di sicurezza del servizio di sistema. In tal caso, questo metodo può restituire un elenco di controllo di accesso (ACL) per limitare l'accesso in lettura o PRTH_S_ACL_IS_READ_EVERYONE per consentire a chiunque l'accesso in lettura durante l'esecuzione di query.

Requisiti

Vedi anche

IUrlAccessor

Messaggi di errore del gestore del protocollo di ricerca