Función NDdeGetShareSecurity
[DDE de red ya no se admite. Nddeapi.dll está presente en Windows Vista, pero todas las llamadas de función devuelven NDDE_NOT_IMPLEMENTED.]
Recupera el descriptor de seguridad asociado al recurso compartido DDE. Esto se hace normalmente para editarlo.
Sintaxis
UINT NDdeGetShareSecurity(
_In_ LPTSTR lpszServer,
_In_ LPTSTR lpszShareName,
_In_ SECURITY_INFORMATION si,
_Out_ PSECURITY_DESCRIPTOR pSD,
_In_ DWORD cbSD,
_Out_ LPDWORD lpcbsdRequired
);
Parámetros
-
lpszServer [in]
-
Nombre del servidor en el que reside el DSDM.
-
lpszShareName [in]
-
Nombre del recurso compartido cuyo descriptor de seguridad se va a recuperar del DSDM. Este parámetro no puede ser NULL.
-
si [in]
-
Valor SECURITY_INFORMATION que especifica la información de seguridad que se va a recuperar del descriptor de seguridad asociado al recurso compartido.
-
pSD [out]
-
Puntero a una estructura SECURITY_DESCRIPTOR que recibe el descriptor de seguridad relativo a sí mismo. Este parámetro puede ser NULL. Si este parámetro es NULL, el DSDM determina el tamaño de la información de seguridad solicitada y devuelve el número de bytes necesarios en el parámetro lpcbsdRequired junto con el código de error NDDE_BUF_TOO_SMALL.
-
cbSD [in]
-
Tamaño del búfer de pSD . Este parámetro debe ser cero si pSD es NULL.
-
lpcbsdRequired [out]
-
Puntero a la variable que recibe el tamaño real del descriptor de seguridad recuperado. Este parámetro no puede ser NULL.
Valor devuelto
Si la función se ejecuta correctamente, se NDDE_NO_ERROR el valor devuelto.
Si se produce un error en la función, el valor devuelto es un código de error, que se puede traducir en un mensaje de error de texto mediante una llamada a NDdeGetErrorString. Si el parámetro pSD era NULL, devuelve NDDE_BUF_TOO_SMALL.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
NDdeGetShareSecurityW (Unicode) y NDdeGetShareSecurityA (ANSI) |