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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP con SP2, Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 con SP1 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | searchapi.h |
| Componente ridistribuibile | Windows Desktop Search (WDS) 3.0 |