IADsNameTranslate::Get-Methode (iads.h)
Die IADsNameTranslate::Get-Methode ruft den Namen eines Verzeichnisobjekts im angegebenen Format ab. Der distinguished name muss von der IADsNameTranslate::Set-Methode im entsprechenden Format festgelegt worden sein.
Syntax
HRESULT Get(
long lnFormatType,
BSTR *pbstrADsPath
);
Parameter
lnFormatType
Der Formattyp des Ausgabenamens. Weitere Informationen finden Sie unter ADS_NAME_TYPE_ENUM. Diese Methode unterstützt das ADS_NAME_TYPE_SID_OR_SID_HISTORY_NAME-Element in ADS_NAME_TYPE_ENUM nicht.
pbstrADsPath
Der Name des zurückgegebenen Objekts.
Rückgabewert
Diese Methode unterstützt die HRESULT-Standardrückgabewerte, einschließlich:
Hinweise
Mit dieser Methode können Sie den Namen eines einzelnen Verzeichnisobjekts abrufen. Verwenden Sie zum Abrufen von Namen mehrerer Objekte IADsNameTranslate::GetEx.
Wenn die Verweisverfolgung aktiviert ist, versucht diese Methode, den Pfad eines angegebenen Objekts zu verfolgen und aufzulösen, das sich nicht auf dem verbundenen Server befindet.
Beispiele
Das folgende C/C++-Codebeispiel zeigt, wie ein distinguished Name, der mit RFC 1779 kompatibel ist, in ein GUID-Format übersetzt wird. Der Computername des Verzeichnisservers lautet "myServer".
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=jeff,CN=Users,DC=myDomain,DC=Fabrikam,DC=COM,O=Internet"));
if(FAILED(hr)) {exit 1;}
BSTR bstr;
hr = pNto->Get(ADS_NAME_TYPE_GUID, &bstr);
printf("Translation: %S\n", bstr);
SysFreeString(bstr);
pNto->Release();
Das folgende Visual Basic-Codebeispiel zeigt, wie ein distinguished Name, der RFC 1779-konform ist, in ein GUID-Format übersetzt wird. Der Computername des Verzeichnisservers lautet "myServer".
Dim nto As New NameTranslate
Dim result As String
dn = "CN=rob,CN=Users,DC=myDomain,DC=Fabrikam,DC=COM,O=Internet"
nto.Init ADS_NAME_INITTYPE_SERVER, "myServer"
nto.Set ADS_NAME_TYPE_1779, dn
result = nto.Get ADS_NAME_TYPE_GUID
MsgBox result
Das folgende VBScript/ASP-Codebeispiel zeigt, wie ein distinguished Name, der mit RFC 1779 kompatibel ist, in ein GUID-Format übersetzt wird. Der Computername des Verzeichnisservers lautet "myServer".
<%@ Language=VBScript %>
<html>
<body>
<%
Dim nto
const ADS_NAME_INITTYPE_SERVER = 2
const ADS_NAME_TYPE_1779 = 1
const ADS_NAME_TYPE_NT4 = 3
server = "myServer"
user = "jeffsmith"
dom = "Fabrikam"
passwd = "top secret"
Set nto = Server.CreateObject("NameTranslate")
nto.InitEx ADS_NAME_INITTYPE_SERVER, server, user, dom, passwd
nto.Set ADS_NAME_TYPE_1779, dn
result = nto.Get(ADS_NAME_TYPE_GUID)
Response.Write "<p>Translated name: " & 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 |