Compartir a través de


Función GetSidIdentifierAuthority (securitybaseapi.h)

La función GetSidIdentifierAuthority devuelve un puntero a la estructura SID_IDENTIFIER_AUTHORITY en un identificador de seguridad (SID) especificado.

Sintaxis

PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
  [in] PSID pSid
);

Parámetros

[in] pSid

Puntero a la estructura de SID para la que se devuelve un puntero a la estructura SID_IDENTIFIER_AUTHORITY .

Esta función no controla las estructuras de SID que no son válidas. Llame a la función IsValidSid para comprobar que la estructura del SID es válida antes de llamar a esta función.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un puntero a la estructura SID_IDENTIFIER_AUTHORITY para la estructura del SID especificado.

Si se produce un error en la función, el valor devuelto no está definido. Se produce un error en la función si la estructura del SID a la que apunta el parámetro pSid no es válida. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Esta función usa un valor rid de 32 bits. Para las aplicaciones que requieren un valor rid mayor, use CreateWellKnownSid y funciones relacionadas.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado securitybaseapi.h (incluya Windows.h)
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

Información general del control de acceso

Funciones básicas de Access Control

CreateWellKnownSid

GetLengthSid

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY