IADsTSUserEx::p ut_TerminalServicesProfilePath 메서드(tsuserex.h)
사용자가 RD 세션 호스트(원격 데스크톱 세션 호스트) 서버에 로그온할 때 사용할 로밍 또는 필수 프로필 경로입니다.
이 속성은 읽기/쓰기가 가능합니다.
구문
HRESULT put_TerminalServicesProfilePath(
BSTR pNewVal
);
매개 변수
pNewVal
반환 값
없음
설명
프로필 경로는 다음과 같은 네트워크 경로 형식입니다.
\\Servername\ProfilesFolderName\사용자
참고 원격 데스크톱 서비스 프로필 경로는 RD 세션 호스트 서버에 로그온하는 데만 사용됩니다.
예제
다음 예제에서는 자격 증명 없이 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(Security Accounts Manager) 데이터베이스에 바인딩하는 스크립트를 보여 줍니다.
두 번째 예제에서는 제공된 자격 증명을 사용하여 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 |
헤더 | tsuserex.h(Tsuserex.h, Tsuserex_i.c 포함) |
DLL | Tsuserex.dll |