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

Vedi anche

IUrlAccessor3

IUrlAccessor4

Messaggi di errore del gestore del protocollo di ricerca