Metodo IADsOpenDSObject::OpenDSObject (iads.h)

Il metodo IADsOpenDSObject::OpenDSObject viene associato a un oggetto ADSI, utilizzando le credenziali specificate e recupera un puntatore IDispatch all'oggetto specificato.

Sintassi

HRESULT OpenDSObject(
  [in]  BSTR      lpszDNName,
  [in]  BSTR      lpszUserName,
  [in]  BSTR      lpszPassword,
  [in]  long      lnReserved,
  [out] IDispatch **ppOleDsObj
);

Parametri

[in] lpszDNName

Stringa Unicode con terminazione Null che specifica l'ADsPath dell'oggetto ADSI. Per altre informazioni ed esempi di stringhe di associazione per questo parametro, vedere LDAP ADsPath. Quando si usa il provider LDAP con un ADsPath che include un nome di server specifico, il parametro lnReserved deve includere il flag ADS_SERVER_BIND.

[in] lpszUserName

Stringa Unicode con terminazione Null che specifica il nome utente da usare per proteggere l'autorizzazione dal server dello spazio dei nomi. Per altre informazioni, vedere la sezione Osservazioni seguente.

[in] lpszPassword

Stringa Unicode con terminazione Null che specifica la password da usare per ottenere l'autorizzazione dal server dello spazio dei nomi.

[in] lnReserved

Flag di autenticazione usati per definire le opzioni di associazione. Per altre informazioni, vedere ADS_AUTHENTICATION_ENUM.

[out] ppOleDsObj

Puntatore a un puntatore a un'interfaccia IDispatch sull'oggetto richiesto.

Valore restituito

Questo metodo supporta i valori restituiti standard, incluso S_OK quando l'interfaccia IDispatch è stata recuperata correttamente usando queste credenziali.

Per altre informazioni, vedere codici di errore ADSI.

Osservazioni

Questo metodo non deve essere usato solo per convalidare le credenziali utente.

Quando viene impostato lnReserved, il comportamento di OpenDSObject dipende dal provider a cui si connette. Gli spazi dei nomi con sicurezza elevata possono ignorare questi flag e richiedere sempre l'autenticazione.

Il metodo IADsOpenDSObject::OpenDSObject gestisce le credenziali utente autenticate e crittografate nella cache. Le credenziali memorizzate nella cache possono essere usate nelle operazioni successive per l'associazione a qualsiasi altro oggetto directory. Le applicazioni client ADSI non devono memorizzare nella cache le credenziali fornite dall'utente. Devono invece basarsi sull'infrastruttura ADSI per eseguire la memorizzazione nella cache. Per usare le credenziali memorizzate nella cache, lpszPassword e lpszUserName devono rimanere invariate in qualsiasi chiamata successiva di OpenDSObject. Nell'esempio di codice seguente viene illustrata questa operazione.

Dim dso As IADsOpenDSObject
Dim obj1, obj2 As IADs
Dim szUsername As String
Dim szPassword As String

Set dso = GetObject("LDAP:")

' Insert code securely.

' Supply full credentials to initiate a server connection.
Set obj1 = dso.OpenDSObject( _
    "LDAP://server1/CN=Dept1,DC=Fabrikam,DC=com", _
    szUsername, _
    szPassword, _
    ADS_SECURE_AUTHENTICATION + ADS_SERVER_BIND)

' Perform an operation with the bound object, obj1
MsgBox obj1.Class

' Bind to another object with the cached user credential.
Set obj2 = dso.OpenDSObject( _
    "LDAP://server1/CN=Dept2,DC=Fabrikam,DC=com", _
    szUsername, _
    szPassword, _
    ADS_SECURE_AUTHENTICATION + ADS_SERVER_BIND)

MsgBox obj2.Class

Le credenziali passate alla funzione IADsOpenDSObject::OpenDSObject vengono usate solo con l'oggetto specifico associato a e non influiscono sul contesto di sicurezza del thread chiamante. Ciò significa che, nell'esempio di codice seguente, la chiamata a IADsOpenDSObject::OpenDSObject userà credenziali diverse rispetto alla chiamata a GetObject.

Dim dso As IADsOpenDSObject
Dim obj1, obj2 As IADs
Dim szUsername As String
Dim szPassword As String

Set dso = GetObject("LDAP:")

' Insert code securely.

' Bind using full credentials.
Set obj1 = dso.OpenDSObject( _
    "LDAP://server1/CN=Dept1,DC=Fabrikam,DC=com", _
    szUsername, _
    szPassword, _
    ADS_SECURE_AUTHENTICATION + ADS_SERVER_BIND)

' Bind to another object with the default credentials.
Set obj2 = GetObject("LDAP://server1/CN=Dept2,DC=Fabrikam,DC=com")

Con un'associazione serverless, il nome del server "server1" non è indicato in modo esplicito. Viene invece utilizzato il server predefinito. Solo il provider LDAP supporta l'associazione serverless. Per usare questa funzionalità, il computer client deve trovarsi in un dominio di Active Directory. Per tentare un'associazione serverless da un computer, è necessario eseguire l'associazione come utente di dominio.

Per il corretto funzionamento della memorizzazione nella cache delle credenziali, è importante mantenere un riferimento a un oggetto in sospeso per mantenere l'handle della cache. Nell'esempio precedente, un tentativo di aprire "obj2" dopo il rilascio di "obj1" genererà un errore di autenticazione.

Il metodo IADsOpenDSObject usa le credenziali predefinite quando lpszUserName e lpszPassword vengono impostati su NULL.

Se l'autenticazione Kerberos è necessaria per il completamento di una richiesta di directory specifica tramite il provider LDAP, la stringa di associazione lpszDNName deve usare un ADsPath serverless, ad esempio "LDAP://CN=Jeff Smith,CN=admin,DC=Fabrikam,DC=com" o deve usare un ADsPath con un nome di server DNS completo, ad esempio "LDAP://central3.corp.Fabrikam.com/CN=Jeff Smith, CN=admin,DC=Fabrikam,DC=com". L'associazione al server usando un nome NETBIOS flat o un nome DNS breve, ad esempio usando il nome breve "central3" anziché "central3.corp.Fabrikam.com", potrebbe o meno restituire l'autenticazione Kerberos.

La funzione helper ADsOpenObject offre le stesse funzionalità del metodo IADsOpenDSObject::OpenDSObject.

Con il provider LDAP per Active Directory, è possibile passare lpszUserName come una delle stringhe seguenti:

• Nome di un account utente, ad esempio "jeffsmith". Per usare un nome utente in modo autonomo, è necessario impostare solo il flag di ADS_SECURE_AUTHENTICATION nel parametro lnReserved .
• Percorso utente da una versione precedente di Windows, ad esempio "Fabrikam\jeffsmith".
• Nome distinto, ad esempio "CN=Jeff Smith,OU=Sales,DC=Fabrikam,DC=Com". Per usare un DN, il parametro lnReserved deve essere zero oppure deve includere il flag ADS_USE_SSL
• Nome dell'entità utente (UPN), ad esempio "jeffsmith@Fabrikam.com". Per usare un UPN, è necessario assegnare il valore UPN appropriato per l'attributo userPrincipalName dell'oggetto utente di destinazione.

Esempi

Nell'esempio di codice seguente viene illustrato come usare IADsOpenDSObject per aprire l'oggetto utente "Administrator" in "Fabrikam" con autenticazione sicura tramite il provider LDAP.

Dim dso As IADsOpenDSObject
Dim domain As IADsDomain
Dim szUsername As String
Dim szPassword As String

On Error GoTo Cleanup

' Insert code to securely retrieve the user name and password.
 
Set dso = GetObject("LDAP:")
Set domain = dso.OpenDSObject("LDAP://Fabrikam", szUsername, _
                              szPassword, _
                              ADS_SECURE_AUTHENTICATION)

Cleanup:
    If (Err.Number <> 0 ) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set dso = Nothing
    Set domain = Nothing

L'esempio di codice seguente usa IADsOpenDSObject per aprire un oggetto Active Directory tramite il provider LDAP.

IADsOpenDSObject *pDSO = NULL;
HRESULT hr = S_OK;
 
hr = ADsGetObject(L"LDAP:", IID_IADsOpenDSObject, (void**) &pDSO);
if (SUCCEEDED(hr))
{
    IDispatch *pDisp;
    hr = pDSO->OpenDSObject(CComBSTR("LDAP://DC=Fabrikam, DC=com"), 
                       CComBSTR("jeffsmith@Fabrikam.com"),
                       CComBSTR("passwordhere"),
                       ADS_SECURE_AUTHENTICATION, 
                       &pDisp);
    pDSO->Release();
    if (SUCCEEDED(hr))
    {
        IADs *pADs;
        hr = pDisp->QueryInterface(IID_IADs, (void**) &pADs);
        pDisp->Release();
        if (SUCCEEDED(hr))
        {
        // Perform an object manipulation here.
            pADs->Release();
        }
    }
}

Fabbisogno

Vedere anche

codici di errore ADSI

ADS_AUTHENTICATION_ENUM

ADsOpenObject

binding

GetObject

IADsOpenDSObject

IDispatch

LDAP ADsPath

WNetAddConnetion2