Funzione ADsGetObject (adshlp.h)

  • Articolo

La funzione ADsGetObject viene associata a un oggetto in base al relativo percorso e a un identificatore di interfaccia specificato.

Sintassi

HRESULT ADsGetObject(
  [in]  LPCWSTR lpszPathName,
  [in]  REFIID  riid,
  [out] VOID    **ppObject
);

Parametri

[in] lpszPathName

Tipo: LPCWSTR

Stringa Unicode con terminazione Null che specifica il percorso utilizzato per l'associazione all'oggetto nel servizio directory sottostante. Per altre informazioni ed esempi di codice per le stringhe di associazione per questo parametro, vedere LDAP ADsPath e WinNT ADsPath.

[in] riid

Tipo: REFIID

Identificatore di interfaccia per un'interfaccia specificata in questo oggetto.

[out] ppObject

Tipo: VOID**

Puntatore a un puntatore all'interfaccia richiesta.

Valore restituito

Tipo: HRESULT

Questo metodo supporta i valori restituiti HRESULT standard, nonché i seguenti.

Per altre informazioni sugli altri valori restituiti, vedere Codici di errore ADSI.

Commenti

Un client C/C++ chiama la funzione helper ADsGetObject per l'associazione a un oggetto ADSI. Equivale a un client Visual Basic che chiama la funzione GetObject . Entrambi accettano un ADsPath come input e restituiscono un puntatore all'interfaccia richiesta. Per impostazione predefinita, l'associazione usa ADS_SECURE_AUTHENTICATION'opzione con il contesto di sicurezza del thread chiamante. Tuttavia, se l'autenticazione non riesce, l'associazione sicura viene sottoposta a downgrade a un'associazione anonima, ad esempio un'associazione semplice senza credenziali utente. Per eseguire l'associazione sicura a un oggetto ADSI, usare la funzione ADsOpenObject anziché la funzione ADsGetObject .

Per un esempio di codice che illustra come usare ADsOpenObject, vedere Binding with GetObject e ADsGetObject.

È possibile eseguire il binding a un oggetto ADSI con credenziali utente diverse da quella dell'utente attualmente connesso. Per eseguire questa operazione, utilizzare la funzione ADsOpenObject .

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione adshlp.h
Libreria Activeds.lib
DLL Activeds.dll

Vedi anche

Codici di errore ADSI

Funzioni ADSI

ADsOpenObject

Binding con GetObject e ADsGetObject