Icmp6SendEcho2
.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 envia uma solicitação de eco ICMPv6 e a chamar retorna um imediatamente, se a Evento Ou ApcRoutine parâmetro é não-NULL, ou retorna após o tempo limite especificado. O ReplyBuffer Contém as respostas ICMP, se houver algum.
Syntax
DWORD WINAPI Icmp6SendEcho2(
HANDLE IcmpHandle,
HANDLE Event,
#ifdef PIO_APC_ROUTINE_DEFINED
PIO_APC_ROUTINE ApcRoutine,
#else
FARPROC ApcRoutine,
#endif
PVOID ApcContext,
struct sockaddr_in6* SourceAddress,
struct sockaddr_in6* DestinationAddress,
LPVOID RequestData,
WORD RequestSize,
PIP_OPTION_INFORMATION RequestOptions,
LPVOID ReplyBuffer,
DWORD ReplySize,
DWORD Timeout
);
Parameters
- IcmpHandle
Um aberto identificador retornado por Icmp6CreateFile.
- Evento
Evento para ser sinalizado sempre que uma resposta ICMPv6 vem em.
- ApcRoutine
Este parâmetro é sempre definido como NULL em Windows Embedded CE.
- ApcContext
Parâmetro opcional. Fornecido ao ApcRoutine parameterwhen esta chamar tiver êxito.
- Endereço_da_origem
Endereço de origem da solicitação de eco.
- DestinationAddress
O destino da solicitação de eco.
- RequestData
Uma reserva contendo os dados para enviar a solicitação.
- RequestSize
O número de bytes de reserva dados a solicitação.
- RequestOptions
Ponteiro para as opções cabeçalho IP para a solicitação. Este parâmetro pode ser NULL.
- ReplyBuffer
Contém uma matriz de ICMPV6_ECHO_REPLY Estruturas seguidas de opções e dados. A reserva deve ser grande o suficiente para conter pelo menos um ICMPV6_ECHO_REPLY estrutura. Ele deve ser grande o suficiente para conter também 8 mais bytes de dados porque este é o tamanho de uma mensagem de erro ICMP.
- ReplySize
O tamanho em bytes de reserva de resposta.
Tempo limite
O tempo em milissegundos para aguardar as respostas.Isso não é usado se ApcRoutine Ou Evento não é NULL.
Return Value
Retorna o número de respostas recebidas e armazenados em ReplyBuffer. Zero indica falha. Informações de erro estendida está disponível através de GetLastError.
Remarks
Em plataformas Other Than Windows NT, o Evento, ApcRoutine e ApcContext Os parâmetros são ignorados.
Requirements
| Header | icmpapi.h |
| Library | icmplib.lib |
| Windows Embedded CE | Windows CE .NET 4.1 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |