Função NDdeShareGetInfo

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 informações de compartilhamento de DDE. Isso geralmente é feito para edição.

Sintaxe

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]: O nome do servidor no qual o DSDM reside.
lpszShareName [in]: O nome do compartilhamento cujas informações devem ser recuperadas do DSDM. Esse parâmetro não deve ser NULL.
nLevel [in]: O nível de informações. Esse parâmetro deve ser 2.
lpBuffer [out]: Um ponteiro para um buffer que recebe a estrutura NDDESHAREINFO e os dados associados apontados por seus membros. Este parâmetro pode ser NULL. Se lpBuffer for NULL, o DSDM calculará o número de bytes necessários para armazenar as informações de compartilhamento solicitadas e retornará esse valor no campo lpnTotalAvailable junto com o erro NDDE_BUF_TOO_SMALL.
cBufSize [in]: O tamanho do buffer lpBuffer , em bytes. Se lpBuffer for NULL, cBufSize deverá ser zero.
lpnTotalAvailable [out]: Um ponteiro para uma variável que recebe o número total de bytes necessários para armazenar as informações de compartilhamento solicitadas. Esse parâmetro não pode ser NULL.
lpnItems [in]: Um ponteiro para uma máscara de seleção de item para recuperação parcial de informações de compartilhamento.

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	NDdeShareGetInfoW (Unicode) e NDdeShareGetInfoA (ANSI)

Confira também

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

Compartilhar via