IADsNameTranslate::InitEx-Methode (iads.h)
Die IADsNameTranslate::InitEx-Methode initialisiert ein Name translate-Objekt durch Bindung an einen angegebenen Verzeichnisserver, eine angegebene Domäne oder einen angegebenen globalen Katalog unter Verwendung der angegebenen Benutzeranmeldeinformationen. Um das Objekt ohne explizite Benutzeranmeldeinformationen zu initialisieren, verwenden Sie IADsNameTranslate::Init.
Die IADsNameTranslate::InitEx-Methode initialisiert das -Objekt, indem der Server oder die Domäne festgelegt wird, auf die das Objekt verweist, und gibt benutzeranmeldeinformationen an.
Syntax
HRESULT InitEx(
long lnSetType,
BSTR bstrADsPath,
BSTR bstrUserID,
BSTR bstrDomain,
BSTR bstrPassword
);
Parameter
lnSetType
Eine Art der auszuführenden Initialisierung. Mögliche Werte werden in ADS_NAME_INITTYPE_ENUM definiert.
bstrADsPath
Der Name des Servers oder der Domäne, abhängig vom Wert von lnInitType. Wenn ADS_NAME_INITTYPE_GC ausgegeben wird, wird dieser Parameter ignoriert. Der globale Katalogserver der Domäne des aktuellen Computers wird zum Ausführen der Namensübersetzungsvorgänge verwendet. Diese Methode schlägt fehl, wenn der Computer nicht Teil einer Domäne ist, da in diesem Szenario kein globaler Katalog gefunden wird. Weitere Informationen finden Sie unter ADS_NAME_INITTYPE_ENUM.
bstrUserID
Benutzername.
bstrDomain
Benutzerdomänenname.
bstrPassword
Benutzerkennwort.
Rückgabewert
Gibt einen Standardmäßigen HRESULT - oder RPC-Fehlercode zurück, einschließlich:
Hinweise
Verwenden Sie nach der erfolgreichen Initialisierung das Name translate-Objekt, um Anforderungen an Namensübersetzungen von Verzeichnisobjekten zu übermitteln. Weitere Informationen finden Sie unter IADsNameTranslate::Set, IADsNameTranslate::Get, IADsNameTranslate::SetEx oder IADsNameTranslate::GetEx.
Beispiele
Im folgenden C/C++-Codebeispiel wird die IADsNameTranslate::InitEx-Methode verwendet, um ein IADsNameTranslate-Objekt zu initialisieren, bevor der distinguished Name eines Benutzerobjekts im s-Format gerendert wird.
IADsNameTranslate *pNto;
HRESULT hr;
hr = CoCreateInstance(CLSID_NameTranslate,
NULL,
CLSCTX_INPROC_SERVER,
IID_IADsNameTranslate,
(void**)&pNto);
if(FAILED(hr)) { exit 1;}
hr = pNto->InitEx(ADS_NAME_INITTYPE_SERVER,
CComBSTR("myServer"),
CComBSTR("jeffsmith"),
CComBSTR("Fabrikam"),
CComBSTR("top secret"));
if (FAILED(hr)) { exit 1;}
hr =pNto->Set(ADS_NAME_TYPE_1779,
CComBSTR("cn=jeffsmith,cn=users,dc=Fabrikam,dc=com"));
if(FAILED(hr)) {exit 1;}
BSTR bstr;
hr = pNto->Get(ADS_NAME_TYPE_NT4, &bstr);
printf("Name in the translated format: %S\n", bstr);
SysFreeString(bstr);
pNto->Release();
Im folgenden Visual Basic-Codebeispiel wird die IADsNameTranslate::InitEx-Methode verwendet, um ein IADsNameTranslate-Objekt zu initialisieren, um den distinguished Name eines Benutzerobjekts im Benutzernamenformat s rendern zu lassen.
Dim nto As New NameTranslate
dso="CN=jeffsmith, CN=users, DC=Fabrikam dc=COM"
server = "myServer"
domain = "Fabrikam"
user = "jeffsmith"
passwd = "myPass"
nto.InitEx ADS_NAME_INITTYPE_SERVER, server,user,domain,passwd
nto.Set ADS_NAME_TYPE_1779, dso
trans = nto.Get(ADS_NAME_TYPE_NT4)
MsgBox "Name in the translated format: " & trans
Im folgenden VBScript/ASP-Codebeispiel wird die IADsNameTranslate::InitEx-Methode verwendet, um ein IADsNameTranslate-Objekt zu initialisieren, damit der distinguished Name eines Benutzerobjekts im Benutzernamenformat s gerendert wird.
<%@ Language=VBScript %>
<html>
<body>
<%
Dim nto
const ADS_NAME_INITTYPE_SERVER = 2 ' VBScript cannot read
const ADS_NAME_TYPE_1779 = 1 ' enumeration definition
const ADS_NAME_TYPE_NT4 = 3
server = "myServer"
domain = "Fabrikam"
user = "jeffsmith"
passwd = "myPass"
dn = "CN=jeffsmith,CN=Users,DC=Fabrikam,DC=COM"
Set nto = Server.CreateObject("NameTranslate")
nto.InitEx ADS_NAME_INITTYPE_SERVER, server,user,domain,passwd
nto.Set ADS_NAME_TYPE_1779, dn
result = nto.Get(ADS_NAME_TYPE_NT4)
Response.Write "<p>Name in the translated format: " & result
%>
</body>
</html>
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |
| DLL | Activeds.dll |