Método IDelaydC::Connect

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

Sintaxis

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

Parámetros

hInputBlob [in]

Identificador del BLOB que especifica la NIC a la que se conecta y la información de configuración sobre esa conexión.

StatusCallbackProc [in]

Dirección de la función de devolución de llamada del usuario, que se usa para recibir actualizaciones de estado como desencadenadores. Si no se usa ninguna 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 este 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 de IDelaydC::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 IDelaydC::Configure .
NMERR_BLOB_ENTRY_DOES_NOT_EXIST	El BLOB de entrada especificado por hInputBlob falta una entrada necesaria para realizar esta operación. Este error puede generarse mediante la llamada IDelaydC::Connect o IDelaydC::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 IDelaydC::Configure .
NMERR_BLOB_STRING_INVALID	La cadena no termina en null. Este error lo genera la llamada IDelaydC::Configure .
NMERR_ILLEGAL_TRIGGER	La parte del desencadenador del BLOB de entrada está dañada. Este error lo genera la llamada IDelaydC::Configure .
NMERR_INVALID_BLOB	El objeto especificado en hInputBlob no es un BLOB. Este error lo genera la llamada IDelaydC::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	No había memoria disponible para realizar esta operación. Este error lo genera la llamada IDelaydC::Configure .
NMERR_TIMEOUT	Se ha agotado el tiempo de espera de la solicitud. Este error lo genera la llamada IDelaydC::Configure .
NMERR_UPLEVEL_BLOB	El número de versión del BLOB especificado en hInputBlob es incorrecto. Este error lo genera la llamada IDelaydC::Configure .

Observaciones

Cuando se llama al método Connect , el NPP llama automáticamente a IDelaydC::Configure mediante el BLOB proporcionado por hInputBlob. Tenga en cuenta que los códigos de error devueltos por la llamada a IDelaydC::Configure se devuelven y devuelven mediante la llamada a IDelaydC::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 los métodos de interfaz IDelaydC para capturar fotogramas.

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

El blob de error devuelto en hErrorBlob contiene información de error que el desarrollador o la aplicación pueden usar para solucionar problemas. El error BLOB devuelto por hErrorBlob contiene entradas que Network Monitor no pudo entender ni encontrar en el BLOB de entrada especificado en hInputBlob. Por ejemplo, si se devuelve NMERR_BLOB_ENTRY_DOES_NOT_EXIST, la entrada Network Monitor no se encuentra 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

IDelaydC

IDelaydC::Configure

IDelaydC::D isconnect

IDelaydC::Start