Función LsaGetAppliedCAPIDs (ntlsa.h)

La función LsaGetAppliedCAPIDs devuelve una matriz de identificadores de directivas de acceso central (CAPP) de todos los CAL aplicados en un equipo específico.

Sintaxis

NTSTATUS LsaGetAppliedCAPIDs(
  [in, optional] PLSA_UNICODE_STRING SystemName,
  [out]          PSID                **CAPIDs,
  [out]          PULONG              CAPIDCount
);

Parámetros

[in, optional] SystemName

Puntero a una estructura de LSA_UNICODE_STRING que contiene el nombre del equipo específico. El nombre puede tener el formato de "NombreDeEquipo" o "\NombreDeEquipo". Si este parámetro es NULL, la función devuelve los CAPID del equipo local.

[out] CAPIDs

Puntero a una variable que recibe una matriz de punteros a CAPID que identifican los CAL disponibles en el equipo especificado. Cuando haya terminado de usar los CAPID, llame a la función LsaFreeMemory en cada elemento de la matriz y toda la matriz.

[out] CAPIDCount

Puntero a una variable que recibe el número de CAL que están disponibles en el equipo especificado. La matriz devuelta en el parámetro CAPIDs contiene el mismo número de elementos que el parámetro CAPIDCount .

Valor devuelto

Si la función se realiza correctamente, se STATUS_SUCCESS el valor devuelto.

Si se produce un error en la función, el valor devuelto es uno de los valores devueltos de la función de directiva LSA. Puede usar la función LsaNtStatusToWinError para convertir el código NTSTATUS en un código de error de Windows.

Comentarios

Para obtener detalles específicos sobre las directivas de acceso central, puede consultar los atributos del objeto de directiva de acceso central en Active Directory en el controlador de dominio del equipo especificado. Busque el objeto cuyo atributo msAuthz-CentralAccessPolicyID coincide con uno de los CAPID devueltos.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ntlsa.h
Library	Advapi32.lib
Archivo DLL	Advapi32.dll

Consulte también

Directiva de autorización centralizada