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.
HRESULT STDMETHODCALLTYPE Connect(
[in] HBLOB hInputBlob,
[in] DWORD StatusCallbackProc,
[in] DWORD UserContext,
[out] HBLOB hErrorBlob
);
-
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.
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 |
---|---|
|
Esta instancia del objeto COM de NPP ya está conectada a la red. |
|
El BLOB de configuración está dañado. Este error lo genera la llamada IESP::Configure . |
|
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ó. |
|
No se ha llamado a la función CreateBlob . Este error lo genera la llamada IESP::Configure . |
|
La cadena no termina en null. Este error lo genera la llamada IESP::Configure . |
|
La parte del desencadenador del BLOB de entrada está dañada. Este error lo genera la llamada IESP::Configure . |
|
El objeto especificado en hInputBlob no es un BLOB. Este error lo genera la llamada IESP::Configure . |
|
El directorio de captura predeterminado no se estableció en el Registro. Use la siguiente ruta de acceso para establecer el directorio de captura.
|
|
La memoria necesaria para realizar esta operación no está disponible. Este error lo genera la llamada IESP::Configure . |
|
Se agota el tiempo de espera de la solicitud. Este error lo genera la llamada IESP::Configure . |
|
El número de versión del BLOB especificado en hInputBlob es incorrecto. Este error lo genera la llamada IESP::Configure . |
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 |
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 |
|
Archivo DLL |
|