IDelaydC::Conectar método

El Conectar 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 [ En]

Controle el BLOB que especifica la NIC a la que se va a conectar y la información de configuración sobre esa conexión.

StatusCallbackProc [ En]

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 [ En]

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]

Controlar un blob de error que contiene información de error adicional.

Valor devuelto

Si este método se realiza correctamente, el valor devuelto es NMERR _ SUCCESS.

Si el método no es correcto, el valor devuelto es uno de los siguientes códigos de error (que incluyen los errores devueltos por la llamada interna 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. La llamada a IDelaydC::Configure genera este error.
NMERR_BLOB_ENTRY_DOES_NOT_EXIST
Al BLOB de entrada especificado por hInputBlob le falta una entrada necesaria para realizar esta operación. Este error lo pueden generar las llamadas IDelaydC::Conectar o IDelaydC::Configure. Mire el blob de error devuelto por hErrorBlob para determinar qué entrada no se encontró.
NMERR_BLOB_NOT_INITIALIZED
No se ha llamado a la función CreateBlob. La llamada a IDelaydC::Configure genera este error.
NMERR_BLOB_STRING_INVALID
La cadena no termina en NULL. La llamada a IDelaydC::Configure genera este error.
NMERR_ILLEGAL_TRIGGER
La parte del desencadenador del BLOB de entrada está dañada. La llamada a IDelaydC::Configure genera este error.
NMERR_INVALID_BLOB
El objeto especificado en hInputBlob no es un BLOB. La llamada a IDelaydC::Configure genera este error.
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY
El directorio de captura predeterminado no se estableció en el Registro. Use la ruta de acceso siguiente 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. La llamada a IDelaydC::Configure genera este error.
NMERR_TIMEOUT
Se ha producido un 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. La llamada a IDelaydC::Configure genera este error.

Observaciones

Cuando se Conectar al método , 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 se devuelven mediante la llamada a IDelaydC::Conectar llamada.

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 blob de error devuelto por hErrorBlob contiene entradas que Monitor de red no se pudieron entender ni encontrar en el BLOB de entrada especificado en hInputBlob. Por ejemplo, si se devuelve NMERR BLOB ENTRY DOES NOT EXIST, la entrada Monitor de red no se encuentra 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
[Solo aplicaciones de escritorio] de Windows 2000 Professional
Servidor mínimo compatible
[Solo aplicaciones de escritorio] de Windows 2000 Server
Encabezado
Netmon.h
Archivo DLL
Ndisnpp.dll;
Rmtnpp.dll

Vea también

IDelaydC

IDelaydC::Configure

IDelaydC::D isconnect

IDelaydC::Start