WSPGetSockName
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função obtém o local de nomes para um Soquete.
Syntax
int WSPGetSockName(
SOCKET s,
struct sockaddr FAR* name,
LPINT namelen,
LPINT lpErrno
);
Parameters
- s
[no] Descritor identificando um ligado Soquete.
- Nome
[out] Ponteiro para uma estrutura usado para fornecer o endereço (Nome) da Soquete.
- namelen
[in, Out] Ponteiro para um inteiro que, na entrada, indica o tamanho da estrutura apontado pelo Nome, e na saída indica o tamanho do nome retornado.
- lpErrno
[out] Ponteiro para o código de erro.
Return Value
Se não houver erro, essa função retornará zero. Caso contrário, será retornado um valor de SOCKET_ERROR e um código de erro específico está disponível em lpErrno.
| Valor de erro | Descrição |
|---|---|
WSAENETDOWN |
falha no subsistema de rede. |
WSAEFAULT |
Nome ou o namelen parâmetro não é um válido parte espaço de endereço de usuário, ou a namelen parâmetro é muito pequeno. |
WSAEINPROGRESS |
Função é chamada quando um callback é em andamento. |
WSAENOTSOCK |
O descritor não é um Soquete. |
WSAEINVAL |
Soquete não foi ligado a um endereço com WSPBind, ou ADDR_ANY é especificado em WSPBind Mas conexão ainda não tenha ocorrido. |
Remarks
Essa função recupera o atual nome para o descritor Soquete especificado em Nome. Ele é usado em um ligado e / ou conectado Soquete especificado pelo s parâmetro. O local associação é retornada. Este chamar é especialmente útil quando um WSPConnect chamar ficou sem fazer um WSPBind Primeiro; Como esse chamar fornece os meios somente pelo qual o local associação que foi definida pelo provedor de serviço pode ser determinada.
Se um Soquete foi ligado a um não especificado endereço (por exemplo, ADDR_ANY), indicando que qualquer um dos endereços da hospedar dentro de família de endereços especificado deve ser usado para o Soquete, essa função será Não Retornar informações sobre o endereço hospedar, necessariamente, a menos que tenha sido conectada a Soquete com WSPConnect Ou WSPAccept. O cliente Windows Sockets SPI não deve assumem que um endereço será especificado, a menos que o Soquete está conectado. Isso ocorre porque para hospedar uma hospedagem múltipla, o endereço que será usado para o Soquete é desconhecido até a Soquete está conectado.
Requirements
| Header | ws2spi.h |
| Library | Ws2.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |