IAzNameResolver::NameFromSid-Methode (azroles.h)

Die NameFromSid-Methode ruft den Anzeigenamen ab, der der angegebenen Sicherheits-ID (SID) entspricht.

Syntax

HRESULT NameFromSid(
  [in]  BSTR bstrSid,
  [out] long *pSidType,
  [out] BSTR *pbstrName
);

Parameter

[in] bstrSid

Die Zeichenfolgendarstellung der zu übersetzenden SID.

[out] pSidType

Ein Element der SID_NAME_USE-Enumeration , das den Typ der zu übersetzenden SID angibt.

[out] pbstrName

Ein Zeiger auf den Anzeigenamen des Prinzipals, der der durch den bstrSid-Parameter angegebenen SID entspricht.

Rückgabewert

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

Bei einem Fehler gibt diese Methode einen Fehlercode zurück. Insbesondere wenn die Methode den Anzeigenamen des Prinzipals nicht finden kann, gibt sie CO_E_NOMATCHINGNAMEFOUND zurück. Eine Liste anderer gängiger Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen