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	Nddeapi.h
Biblioteca	Nddeapi.lib
Archivo DLL	Nddeapi.dll
Nombres Unicode y ANSI	NDdeGetShareSecurityW (Unicode) y NDdeGetShareSecurityA (ANSI)

Vea también

Información general sobre intercambio dinámico de datos de red

Funciones DDE de red

SECURITY_INFORMATION

NDdeSetShareSecurity