IADsTSUserEx::get_TerminalServicesProfilePath-Methode (tsuserex.h)

Artikel
08/26/2023

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

Hinweis Ein Remotedesktopdienste-Profilpfad wird nur für die Anmeldung bei einem RD-Sitzungshostserver verwendet.

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


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	tsuserex.h (einschließlich Tsuserex.h, Tsuserex_i.c)
DLL	Tsuserex.dll

Weitere Informationen

IADsTSUserEx

Freigeben über