IADsNameTranslate::Set-Methode (iads.h)
Die IADsNameTranslate::Set-Methode weist den Verzeichnisdienst an, ein angegebenes Objekt für die Namensübersetzung einzurichten. Um die Namen und das Format mehrerer Objekte festzulegen, verwenden Sie IADsnametranslate::SetEx.
Syntax
HRESULT Set(
long lnSetType,
BSTR bstrADsPath
);
Parameter
lnSetType
Das Format des Namens eines Verzeichnisobjekts. Weitere Informationen finden Sie unter ADS_NAME_TYPE_ENUM.
bstrADsPath
Der Objektname, z. B. "CN=Administrator, CN=users, DC=Fabrikam, DC=com".
Rückgabewert
Diese Methode unterstützt die HRESULT-Standardrückgabewerte, einschließlich:
Hinweise
Bevor Sie diese Methode zum Festlegen des Objektnamens aufrufen, sollten Sie eine Verbindung mit dem Verzeichnisdienst hergestellt haben, indem Sie entweder IADsNameTranslate::Init oder IADsNameTranslate::InitEx verwenden.
Sie können die IADsNameTranslate::Set-Methode verwenden, um die Namensübersetzung für Objekte festzulegen, die sich auf dem Verzeichnisserver befinden. Wenn die Verweisjagd aktiviert ist, legt diese Methode auch jedes Objekt fest, das auf anderen Servern gefunden wird. Weitere Informationen zur Empfehlungssuche finden Sie unter Methoden der IADsNameTranslate-Eigenschaft.
Beispiele
Im folgenden C/C++-Codebeispiel wird die IADsNameTranslate::Set-Methode verwendet, um ein Objekt festzulegen, damit sein Name aus dem RFC 1779-Format in das s-Benutzernamenformat übersetzt werden kann.
IADsNameTranslate *pNto;
HRESULT hr;
hr = CoCreateInstance(CLSID_NameTranslate,
NULL,
CLSCTX_INPROC_SERVER,
IID_IADsNameTranslate,
(void**)&pNto);
if(FAILED(hr)) { exit 1;}
hr = pNto->Init(ADS_NAME_INITTYPE_SERVER,
CComBSTR("myServer"));
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::Set-Methode verwendet, um ein Objekt festzulegen, damit sein Name aus dem RFC 1779-Format in das Benutzernamenformat s übersetzt werden kann.
Dim nto As New NameTranslate
dso="CN=jeffsmith, CN=users, DC=Fabrikam dc=COM"
nto.Init ADS_NAME_INITTYPE_SERVER, "myServer"
nto.Set ADS_NAME_TYPE_1779, dso
trans = nto.Get(ADS_NAME_TYPE_NT4)
Im folgenden VBScript/ASP-Codebeispiel wird die IADsNameTranslate::Set-Methode verwendet, um ein Objekt so festzulegen, dass sein Name aus dem RFC 1779-Format in das Benutzernamenformat s übersetzt 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
dn = "CN=jeffsmith,CN=Users,DC=Fabrikam,DC=COM"
Set nto = Server.CreateObject("NameTranslate")
nto.Init ADS_NAME_INITTYPE_SERVER, "myServer"
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
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |
| DLL | Activeds.dll |