UserEnumLocalGroups  

ITcUserManager::UserEnumLocalGroups  

Liefert die Benutzergruppen zu denen ein Benutzer gehört zurück.

HRESULT UserEnumLocalGroups(
  VARIANT varUserName,
  SAFEARRAY(BSTR)* ppGroups
);

Parameters

varUserName

[in, optional]
Optional kann der Name eines Benutzers als BSTR übergeben werden. Wird kein Name übergeben, so wird der Benutzer des aufrufenden Threads abgefragt.

ppGroups

[out, retval]
Zeiger auf SAFEARRAY von BSTRs, in denen die Namen der Benutzergruppen hinterlegt sind.

Return Values

HRESULT == S_OK

Abfrage erfolgreich durchgeführt.

HRESULT != S_OK

Im Fehlerfall steht in HRESULT ein von Windows NT generierter Fehlercode. Um eine COM/OLE Fehlerbehandlung zu provozieren, wird aus dem Fehlercode ein HRESULT durch HRESULT_FROM_NT(nErrror) erzeugt. Zu beachten ist hierbei, dass der Windows NT Fehlercode in niederwertigen 16 Bit dargestellt wird.