IADsTSUserEx::get_TerminalServicesProfilePath-Methode (tsuserex.h)

Der Roaming- oder obligatorische Profilpfad, der verwendet werden soll, wenn sich der Benutzer beim Remotedesktopsitzungshostserver (RD-Sitzungshost) anmeldet.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT get_TerminalServicesProfilePath(
  BSTR *pVal
);

Parameter

pVal

Rückgabewert

Keine

Bemerkungen

Der Profilpfad hat das folgende Netzwerkpfadformat:

\\Servername\ProfileFolderName\Nutzername

Beispiele

Das folgende Beispiel zeigt ein Programm, das ohne Anmeldeinformationen an die Active Directory-Datenbank bindet.

 IADsContainer *pContainer = NULL;
 IDispatch *pNewObject = NULL;
 IADsTSUserEx *pTSUser = NULL;
 IADsUser *pUser = NULL;
 HRESULT hr = ERROR_SUCCESS;

 CoInitialize(NULL);
 //
 // Bind to the known container.
 //
 hr = ADsGetObject(
    L"LDAP://DOMAIN/CN=Users,DC=Server1,DC=Domain,DC=com",
    IID_IADsContainer,
    (void**)&pContainer);

 if( !SUCCEEDED(hr)) {
  wprintf(L"ADsGetObject ret failed with 0x%x\n", hr);
  return FALSE;
 }
 //
 // Create the new Active Directory Service Interfaces User object.
 //
 hr = pContainer->Create(L"user",
                         L"cn=test3",
                         &pNewObject);
 pContainer->Release();

 if( !SUCCEEDED(hr)) {
  wprintf(L"Create ret failed with 0x%x\n", hr);
  return FALSE;
 }
 //
 // Get the IADsTSUser interface from the user object.
 //
 hr = pNewObject->QueryInterface(IID_IADsTSUserEx, (void**)&pTSUser);

 if( !SUCCEEDED(hr)) { 
  wprintf(L"QueryInterface for IADsTSUserEx failed with ret 0x%x\n",
          hr);
  return FALSE;
 }
 //
 // Get the IADsTSUser interface from the user object.
 //
 hr = pNewObject->QueryInterface(IID_IADsUser, (void**)&pUser);

 if( !SUCCEEDED(hr)) {
  wprintf(L"QueryInterface for IAsUser failed with 0x%x\n", hr);
  return FALSE;
 }
 pNewObject->Release();

 //
 // Set TerminalServicesProfilePath
 //
 pTSUser->put_TerminalServicesProfilePath(L"c:\\windows");
 pTSUser->Release();

 //
 // Commit the object data to the directory.
 //
 pUser->SetInfo();
 pUser->Release();
 CoUninitialize();

Sie können die folgenden Skriptbeispiele verwenden, um an den Namespace eines Anbieters zu binden. Zwei Beispiele binden mit den angegebenen Anmeldeinformationen. zwei binden ohne Anmeldeinformationen.

Das erste Beispiel zeigt ein Skript, das mit den angegebenen Anmeldeinformationen an die SAM-Datenbank (Security Accounts Manager) gebunden wird.

Das zweite Beispiel zeigt ein Skript, das mit den angegebenen Anmeldeinformationen an die Active Directory-Datenbank gebunden ist.

Set DSO = GetObject("WinNT:")
Set usr = DSO.OpenDSObject(
    "WinNT://Server1/Test,user",
    Domain\User,
    Password,
    ADS_SECURE_AUTHENTICATION)
Wscript.echo usr.TerminalServicesProfilePath
usr.TerminalServicesProfilePath = "profile path"
usr.SetInfo
WScript.echo usr.TerminalServicesProfilePath

Set DSO = GetObject("LDAP:")
Set usr = DSO.OpenDSObject(
    "LDAP://DOMAIN/CN=Test,CN=Users,DC=Server1,DC=Domain,DC=com",
    Domain\User,
    Password,
    ADS_SECURE_AUTHENTICATION)
Wscript.echo usr.TerminalServicesProfilePath
usr.TerminalServicesProfilePath = "profile path"
usr.SetInfo
WScript.echo usr.TerminalServicesProfilePath

Anforderungen

Weitere Informationen

IADsTSUserEx