estrutura SERVICE_ADDRESS (nspapi.h)

  • Artigo

A estrutura SERVICE_ADDRESS contém informações de endereço para um serviço. A estrutura pode acomodar muitos tipos de mecanismos de IPC (comunicações entre processos) e seus formulários de endereço, incluindo RPC (chamadas de procedimento remoto), pipes nomeados e soquetes.

Sintaxe

typedef struct _SERVICE_ADDRESS {
  DWORD dwAddressType;
  DWORD dwAddressFlags;
  DWORD dwAddressLength;
  DWORD dwPrincipalLength;
#if ...
  BYTE  *lpAddress;
#else
  BYTE  *lpAddress;
#endif
#if ...
  BYTE  *lpPrincipal;
#else
  BYTE  *lpPrincipal;
#endif
} SERVICE_ADDRESS, *PSERVICE_ADDRESS, *LPSERVICE_ADDRESS;

Membros

dwAddressType

Tipo: DWORD

A família de endereços à qual o endereço do soquete apontado pelo membro lpAddress pertence.

dwAddressFlags

Tipo: DWORD

Um conjunto de sinalizadores de bits que especificam propriedades do endereço. Os sinalizadores de bit a seguir são definidos.

Valor Significado
SERVICE_ADDRESS_FLAG_RPC_CN
 Se esse sinalizador de bit estiver definido, o serviço oferecerá suporte ao RPC orientado à conexão por esse protocolo de transporte.
SERVICE_ADDRESS_FLAG_RPC_DG
 Se esse sinalizador de bits estiver definido, o serviço oferecerá suporte ao RPC orientado a datagram sobre esse protocolo de transporte.
SERVICE_ADDRESS_FLAG_RPC_NB
 Se esse sinalizador de bit estiver definido, o serviço oferecerá suporte a RPC NetBIOS por esse protocolo de transporte.

dwAddressLength

Tipo: DWORD

O tamanho, em bytes, do endereço.

dwPrincipalLength

Tipo: DWORD

Reservado para uso futuro. Deve ser zero.

lpAddress

Tipo: BYTE*

Um ponteiro para um endereço de soquete do tipo apropriado.

lpPrincipal

Tipo: BYTE*

Reservado para uso futuro. Deve ser NULL.

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 nspapi.h

Confira também

SERVICE_ADDRESSES

SERVICE_INFO