IAzNameResolver::NamesFromSids-Methode (azroles.h)

Die NamesFromSids-Methode ruft die Anzeigenamen ab, die den angegebenen Sicherheitsbezeichnern (SIDs) entsprechen.

Syntax

HRESULT NamesFromSids(
  [in]  VARIANT vSids,
  [out] VARIANT *pvSidTypes,
  [out] VARIANT *pvNames
);

Parameter

[in] vSids

Ein Array von Zeichenfolgendarstellungen der zu übersetzenden SIDs.

Dies ist eine Variante, die entweder ein SAFEARRAY - oder das JScript-Array-Objekt enthält. Jedes Element des Arrays enthält eine VT_BSTR , die eine Zeichenfolgendarstellung einer SID enthält.

[out] pvSidTypes

Ein Zeiger auf ein Array von Elementen der SID_NAME_USE-Enumeration , die die Typen der zu übersetzenden SIDs angeben.

Dies ist eine Variante, die entweder ein SAFEARRAY - oder das JScript-Array-Objekt enthält. Jedes Element des Arrays enthält einen VT_I4 Wert, der ein Element der SID_NAME_USE-Enumeration angibt.

[out] pvNames

Ein Zeiger auf ein Array von Zeichenfolgen, das die Anzeigenamen der Prinzipale enthält, die den durch den vSids-Parameter angegebenen SIDs entsprechen.

Dies ist eine Variante, die entweder ein SAFEARRAY - oder das JScript-Array-Objekt enthält. Jedes Element des Arrays enthält eine VT_BSTR , die einen Anzeigenamen enthält. Wenn für eine oder mehrere siDs kein Name gefunden werden konnte, enthält das entsprechende Arrayelement eine leere Zeichenfolge.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben.

Bei einem Fehler gibt diese Methode einen Fehlercode zurück. Wenn die Methode die Anzeigenamen eines der Prinzipale nicht finden kann, gibt sie CO_E_NOMATCHINGNAMEFOUND zurück. Eine Liste anderer gängiger Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	azroles.h