Metodo IUrlAccessor3::GetImpersonationSidBlobs (searchapi.h)
Recupera una matrice di identificatori di sicurezza utente (SID) per un URL specificato. Questo metodo consente ai gestori del protocollo di specificare quali utenti possono accedere al file e all'host del protocollo di ricerca per rappresentare un utente per indicizzare il file.
Sintassi
HRESULT GetImpersonationSidBlobs(
[in] LPCWSTR pcwszURL,
[out] DWORD *pcSidCount,
[out] BLOB **ppSidBlobs
);
Parametri
[in] pcwszURL
Tipo: LPCWSTR
URL a cui accedere per conto di un utente rappresentato.
[out] pcSidCount
Tipo: DWORD*
Riceve un puntatore al numero di SID utente restituiti in ppSidBlobs.
[out] ppSidBlobs
Tipo: BLOB**
Riceve l'indirizzo di un puntatore alla matrice di SID utente di rappresentazione del candidato.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Se il file è crittografato, questo metodo identifica chi può decrittografare e accedervi. Se il metodo non riesce a identificare queste informazioni, non riesce con il codice di errore E_ACCESSDENIED.
Questo metodo presuppone che l'oggetto IUrlAccessor2 non sia riuscito a inizializzare e restituire il codice PRTH_S_TRY_IMPERSONATING. L'host del protocollo di ricerca chiama quindi questo metodo per recuperare un elenco di SID da usare per la rappresentazione e il ripristino all'uso di IUrlAccessor2, rappresentando uno degli utenti consentiti durante l'apertura dell'elemento.
La rappresentazione di un utente non eleva i privilegi del chiamante. Se il chiamante non può recuperare direttamente l'elenco di utenti autorizzati ad accedere a una risorsa, il chiamante non sarà in grado di farlo con questo metodo. Solo l'host del protocollo di ricerca e l'indicizzatore hanno privilegi adeguati per rappresentare gli utenti attualmente connessi.
Requisiti
| Client minimo supportato | Windows XP con SP2, Windows Vista con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 con SP1 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | searchapi.h |
| Componente ridistribuibile | Windows Search (WS) 4.0 |