Función CheckTokenMembershipEx (securitybaseapi.h)

La función CheckTokenMembershipEx determina si el SID especificado está habilitado en el token especificado.

Sintaxis

BOOL CheckTokenMembershipEx(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   SidToCheck,
  [in]           DWORD  Flags,
  [out]          PBOOL  IsMember
);

Parámetros

[in, optional] TokenHandle

Identificador de un token de acceso. Si está presente, este token se comprueba para el SID. Si no está presente, se usa el token efectivo actual. Debe ser un token de suplantación.

[in] SidToCheck

Puntero a una estructura SID. La función comprueba la presencia de este SID en presencia del token.

[in] Flags

Marcas que afectan al comportamiento de la función. Actualmente, la única marca válida es CTMF_INCLUDE_APPCONTAINER que permite que los contenedores de aplicaciones pasen la llamada siempre que se cumplan los demás requisitos del token, como el grupo especificado está presente y habilitado.

[out] IsMember

TRUE si el SID está habilitado en el token; de lo contrario, FALSE.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE.

Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Cliente mínimo compatible	Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	securitybaseapi.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Kernel32.dll