IESP::Connect (método)

El método Connect conecta el NPP a la red mediante una NIC especificada y proporciona información de configuración sobre la conexión.

Sintaxis

HRESULT STDMETHODCALLTYPE Connect(
  [in]  HBLOB hInputBlob,
  [in]  DWORD StatusCallbackProc,
  [in]  DWORD UserContext,
  [out] HBLOB hErrorBlob
);

Parámetros

hInputBlob [in]

Controle al BLOB que especifica la NIC a la que se conecta el NPP y la información de configuración de esa conexión.

StatusCallbackProc [in]

Dirección de la función de devolución de llamada del usuario, que recibe actualizaciones de estado como desencadenadores. Si no se usa una función de devolución de llamada, establezca este parámetro y el parámetro UserContext en NULL.

UserContext [in]

Valor pasado cuando se llama a la función de devolución de llamada del usuario. El valor de este parámetro suele ser HWND o un puntero "this". Si no se especifica una función de devolución de llamada, establezca este parámetro y el parámetro StatusCallbackProc en NULL.

hErrorBlob [out]

Identificador de un BLOB de error que contiene información de error adicional.

Valor devuelto

Si el método se ejecuta correctamente, el valor devuelto se NMERR_SUCCESS.

Si el método no se realiza correctamente, el valor devuelto es uno de los siguientes códigos de error (que incluyen los errores devueltos por la llamada interna IESP::Configure ):

Código devuelto Descripción
NMERR_ALREADY_CONNECTED
Esta instancia del objeto COM de NPP ya está conectada a la red.
NMERR_BLOB_CONVERSION_ERROR
El BLOB de configuración está dañado. Este error lo genera la llamada IESP::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
El BLOB de entrada especificado por el parámetro hInputBlob carece de una entrada necesaria para realizar esta operación. Este error puede generarse mediante la llamada IESP::Connect o IESP::Configure . Examine el error BLOB devuelto por hErrorBlob para determinar qué entrada no se encontró.
NMERR_BLOB_NOT_INITIALIZED
No se ha llamado a la función CreateBlob . Este error lo genera la llamada IESP::Configure .
NMERR_BLOB_STRING_INVALID
La cadena no termina en null. Este error lo genera la llamada IESP::Configure .
NMERR_ILLEGAL_TRIGGER
La parte del desencadenador del BLOB de entrada está dañada. Este error lo genera la llamada IESP::Configure .
NMERR_INVALID_BLOB
El objeto especificado en hInputBlob no es un BLOB. Este error lo genera la llamada IESP::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY
El directorio de captura predeterminado no se estableció en el Registro. Use la siguiente ruta de acceso para establecer el directorio de captura.
HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath
NMERR_OUT_OF_MEMORY
La memoria necesaria para realizar esta operación no está disponible. Este error lo genera la llamada IESP::Configure .
NMERR_TIMEOUT
Se agota el tiempo de espera de la solicitud. Este error lo genera la llamada IESP::Configure .
NMERR_UPLEVEL_BLOB
El número de versión del BLOB especificado en hInputBlob es incorrecto. Este error lo genera la llamada IESP::Configure .

Observaciones

Cuando se llama al método Connect , Network Monitor llama automáticamente a IESP::Configure mediante el blob proporcionado por el parámetro hInputBlob . Tenga en cuenta que los códigos de error devueltos por la llamada a IESP::Configure se devuelven y devuelven mediante la llamada a IESP::Connect .

Se debe llamar a este método para poder empezar a capturar fotogramas. Tenga en cuenta que al conectarse a la red mediante este método, debe seguir usando la interfaz IESP para capturar fotogramas.

El BLOB de entrada especificado por hInputBlob se puede obtener llamando a GetNPPBlobFromUI, GetNPPBlobTable y SelectNPPBlobFromTable.

El error BLOB devuelto por hErrorBlob contiene entradas que Network Monitor no pudo entender ni encontrar en el BLOB de entrada especificado en hInputBlob. El BLOB de error devuelto contiene información de error que la aplicación puede usar para solucionar problemas. Por ejemplo, si se devuelve NMERR_BLOB_ENTRY_DOES_NOT_EXIST, la entrada que network Monitor no pudo encontrar se incluye en el blob de error devuelto.

Para información acerca de Vea
Obtención del BLOB de entrada que representa una NIC Selección de una tarjeta de interfaz de red

Requisitos

Requisito Value
Cliente mínimo compatible
Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible
Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado
Netmon.h
Archivo DLL
Ndisnpp.dll;
Rmtnpp.dll

Vea también

IESP

IESP::Configure

IESP::D isconnect

IESP::Start