Función GetAppliedGPOListA (userenv.h)
La función GetAppliedGPOList recupera la lista de GPO aplicados al usuario o equipo especificados.
Sintaxis
USERENVAPI DWORD GetAppliedGPOListA(
[in] DWORD dwFlags,
[in] LPCSTR pMachineName,
[in] PSID pSidUser,
[in] GUID *pGuidExtension,
[out] PGROUP_POLICY_OBJECTA *ppGPOList
);
Parámetros
[in] dwFlags
Valor que especifica el tipo de directiva. Este parámetro puede ser el siguiente valor.
GPO_LIST_FLAG_MACHINE
Recupera información sobre la directiva de equipo.
Si no se especifica este valor, la función recupera solo la información de la directiva de usuario.
[in] pMachineName
Puntero al nombre del equipo remoto. El formato del nombre es "\\computer_name". Si este parámetro es NULL, se usa el nombre del equipo local.
[in] pSidUser
Valor que especifica el SID del usuario. Si pMachineName no es NULL y dwFlags especifica la directiva de usuario, pSidUser no puede ser NULL.
Si pMachineName es NULL y pSidUser es NULL, el usuario es el usuario que ha iniciado sesión actualmente. Si pMachineName es NULL y pSidUser no es NULL, el usuario se representa mediante pSidUser en el equipo local. Para obtener más información, consulte Identificadores de seguridad.
[in] pGuidExtension
Valor que especifica el GUID de la extensión.
[out] ppGPOList
Puntero que recibe la lista de estructuras de GPO. Para obtener más información, consulte GROUP_POLICY_OBJECT.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto se ERROR_SUCCESS. De lo contrario, la función devuelve un código de error del sistema. Para obtener una lista completa de los códigos de error, consulta Códigos de error del sistema o el archivo de encabezado WinError.h.
Comentarios
Para liberar la lista de GPO cuando haya terminado de procesarla, llame a la función FreeGPOList .
Nota
El encabezado userenv.h define GetAppliedGPOList como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | userenv.h |
| Library | Userenv.lib |
| Archivo DLL | Userenv.dll |