Función AuthzModifySids (authz.h)

La función AuthzModifySids agrega, elimina o modifica los grupos de usuarios y dispositivos en el contexto del cliente de Authz.

Sintaxis

AUTHZAPI BOOL AuthzModifySids(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE     hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS SidClass,
  [in]           PAUTHZ_SID_OPERATION            pSidOperations,
  [in, optional] PTOKEN_GROUPS                   pSids
);

Parámetros

[in] hAuthzClientContext

Identificador del contexto de cliente que se va a modificar.

[in] SidClass

Tipo de información que se va a modificar. El autor de la llamada puede especificar AuthzContextInfoGroupsSids, AuthzContextInfoRestrictedSids o AuthzContextInfoDeviceSids.

[in] pSidOperations

Puntero a una matriz de AUTHZ_SID_OPERATION valores de enumeración que especifican las modificaciones de grupo que se van a realizar.

[in, optional] pSids

Puntero a una estructura TOKEN_GROUPS que especifica los grupos que se van a modificar.

Valor devuelto

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

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

Comentarios

La enumeración AUTHZ_SID_OPERATION debe tener solo un elemento si el valor de ese elemento es AUTHZ_SID_OPERATION_REPLACE_ALL. De lo contrario, la matriz tiene el mismo número de elementos que el PTOKEN_GROUPS correspondiente.

Si desea usar AuthzModifySids para eliminar, los SID se comparan, pero no las marcas de SID. Si no se encuentra ningún SID coincidente, no se realiza ninguna modificación y se produce un error en la llamada.

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	authz.h
Library	Authz.lib
Archivo DLL	Authz.dll