Función NDdeShareGetInfo

[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 información de recurso compartido de DDE. Esto suele hacerse para editarlo.

Sintaxis

UINT NDdeShareGetInfo(
  _In_  LPTSTR  lpszServer,
  _In_  LPTSTR  lpszShareName,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnTotalAvailable,
  _In_  LPWORD  lpnItems
);

Parámetros

lpszServer [in]

Nombre del servidor en el que reside el DSDM.

lpszShareName [in]

Nombre del recurso compartido cuya información se va a recuperar del DSDM. Este parámetro no debe ser NULL.

nLevel [in]

Nivel de información. Este parámetro debe ser 2.

lpBuffer [out]

Puntero a un búfer que recibe la estructura NDDESHAREINFO y los datos asociados a los que apuntan sus miembros. Este parámetro puede ser NULL. Si lpBuffer es NULL, el DSDM calcula el número de bytes necesarios para almacenar la información de recurso compartido solicitada y devuelve ese valor en el campo lpnTotalAvailable junto con el error de NDDE_BUF_TOO_SMALL.

cBufSize [in]

Tamaño del búfer lpBuffer , en bytes. Si lpBuffer es NULL, cBufSize debe ser cero.

lpnTotalAvailable [out]

Puntero a una variable que recibe el número total de bytes necesarios para almacenar la información de recurso compartido solicitada. Este parámetro no puede ser NULL.

lpnItems [in]

Puntero a una máscara de selección de elementos para la recuperación parcial de información de recursos compartidos.

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 lpBuffer es 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	NDdeShareGetInfoW (Unicode) y NDdeShareGetInfoA (ANSI)

Consulte también

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

Funciones DDE de red

NDDESHAREINFO

NDdeShareSetInfo