Função NDdeShareEnum

Artigo
06/13/2023

[Não há mais suporte para DDE de rede. Nddeapi.dll está presente no Windows Vista, mas todas as chamadas de função retornam NDDE_NOT_IMPLEMENTED.]

Recupera a lista de compartilhamentos DDE disponíveis.

Sintaxe

UINT NDdeShareEnum(
  _In_  LPTSTR  lpszServer,
  _In_  UINT    nLevel,
  _Out_ LPBYTE  lpBuffer,
  _In_  DWORD   cBufSize,
  _Out_ LPDWORD lpnEntriesRead,
  _Out_ LPDWORD lpcbTotalAvailable
);

Parâmetros

lpszServer [in]: O nome do servidor no qual o DSDM reside.
nLevel [in]: Reservado. Esse parâmetro deve ser zero.
lpBuffer [out]: Um ponteiro para um buffer que recebe a lista de compartilhamentos DDE. A lista de compartilhamentos DDE é armazenada como uma sequência de cadeias de caracteres separadas por nulo terminando com um caractere nulo duplo no final. Este parâmetro pode ser NULL. Se lpBuffer for NULL, o DSDM retornará o tamanho do buffer necessário para manter a lista de compartilhamentos no parâmetro lpcbTotalAvailable .
cBufSize [in]: O tamanho do buffer lpBuffer , em bytes. Esse parâmetro deverá ser zero se lpBuffer for NULL.
lpnEntriesRead [out]: Um ponteiro para uma variável que recebe o número total de compartilhamentos sendo enumerados. Esse parâmetro não pode ser NULL.
lpcbTotalAvailable [out]: Um ponteiro para uma variável que recebe o número total de bytes necessários no buffer para armazenar a lista de compartilhamentos DDE. Esse parâmetro não pode ser NULL.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NDDE_NO_ERROR.

Se a função falhar, o valor retornado será um código de erro, que pode ser convertido em uma mensagem de erro de texto chamando NDdeGetErrorString. Se o parâmetro lpBuffer for NULL, ele retornará NDDE_BUF_TOO_SMALL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Nddeapi.h
Biblioteca	Nddeapi.lib
DLL	Nddeapi.dll
Nomes Unicode e ANSI	NDdeShareEnumW (Unicode) e NDdeShareEnumA (ANSI)

Confira também

Visão geral da Troca dinâmica de dados de rede
Funções DDE de rede

Compartilhar via