IADsTSUserEx::p ut_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 put_TerminalServicesProfilePath(
BSTR pNewVal
);
Parameter
pNewVal
Rückgabewert
Keine
Bemerkungen
Der Profilpfad hat das folgende Netzwerkpfadformat:
\\Servername\ProfilesFolderName\Nutzername
Beispiele
Das folgende Beispiel zeigt ein Programm, das ohne Anmeldeinformationen an die Active Directory-Datenbank gebunden wird.
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 eine Bindung an den Namespace eines Anbieters zu erstellen. Zwei Beispiele binden an die angegebenen Anmeldeinformationen; zwei Bindungen 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 wird.
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
Anforderung | Wert |
---|---|
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 |