Compartir a través de

Función CheckTokenMembershipEx (securitybaseapi.h)

  • Artículo

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