Метод IADsTSUserEx::p ut_TerminalServicesProfilePath (tsuserex.h)

Статья
08/26/2023

Перемещаемый или обязательный путь к профилю, используемый при входе пользователя на сервер узла сеансов удаленных рабочих столов (узла сеансов удаленных рабочих столов).

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT put_TerminalServicesProfilePath(
  BSTR pNewVal
);

Параметры

pNewVal

Возвращаемое значение

None

Remarks

Путь к профилю имеет следующий формат сетевого пути:

\\Имя _сервера\ProfilesFolderName\Пользователя

Примечание Путь к профилю служб удаленных рабочих столов используется только для входа на сервер узла сеансов удаленных рабочих столов.

Примеры

В следующем примере показана программа, которая выполняет привязку к базе данных Active Directory без учетных данных.

 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();

Следующие примеры скриптов можно использовать для привязки к пространству имен поставщика. Два примера привязки с предоставленными учетными данными; две привязки без учетных данных.

В первом примере показан скрипт, который привязывается к базе данных диспетчера учетных записей безопасности (SAM) с предоставленными учетными данными.

Во втором примере показан скрипт, который привязывается к базе данных Active Directory с предоставленными учетными данными.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	tsuserex.h (включая Tsuserex.h, Tsuserex_i.c)
DLL	Tsuserex.dll

См. также раздел

IADsTSUserEx

Поделиться через