Método IStats::Connect

El método Connect conecta el NPP a la red mediante una NIC especificada y proporciona información de configuración para 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 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 realiza 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 IStats::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 IStats::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 IStats::Connect o IStats::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 IStats::Configure .
NMERR_BLOB_STRING_INVALID	La cadena no termina en null. Este error lo genera la llamada IStats::Configure .
NMERR_ILLEGAL_TRIGGER	La parte del desencadenador del BLOB de entrada está dañada. Este error lo genera la llamada IStats::Configure .
NMERR_INVALID_BLOB	El objeto especificado en hInputBlob no es un BLOB. Este error lo genera la llamada IStats::Configure .
NMERR_NO_DEFAULT_CAPTURE_DIRECTORY	El directorio de captura predeterminado no se estableció en el Registro. Para establecer el directorio de captura, use la ruta de acceso siguiente. HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\nm\Parameters\CapturePath
NMERR_OUT_OF_MEMORY	La memoria necesaria para realizar esta operación no estaba disponible. Este error lo genera la llamada IStats::Configure .
NMERR_TIMEOUT	Se ha agotado el tiempo de espera de la solicitud. Este error lo genera la llamada IStats::Configure .
NMERR_UPLEVEL_BLOB	El número de versión del BLOB especificado en hInputBlob es incorrecto. Este error lo genera la llamada IStats::Configure .

Comentarios

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

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

El error BLOB devuelto por el parámetro 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 tarjeta de interfaz de red	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

Consulte también

IStats

IStats::Configure

IStats::D isconnect

BLOBS de Monitor de red