XNetworkingUnregisterConnectivityHintChanged
Anula el registro de una función de devolución de llamada que se registró con XNetworkingRegisterConnectivityHintChanged.Sintaxis
Parámetros
token _In_Tipo: XTaskQueueRegistrationToken Token devuelto por XNetworkingRegisterConnectivityHintChanged. wait _In_
Tipo: bool Indica si se debe bloquear hasta que se completen las devoluciones de llamada pendientes.
Valor devuelto
Tipo: bool Devuelve false si wait es false y la llamada de anulación del registro está pendiente. Devuelve true en caso contrario.Comentarios
No es seguro llamar a esta función en un subproceso con restricciones de tiempo. Para obtener más información, consulte Subprocesos con restricciones de tiempo.
- La devolución de llamada asociada al token se quita del conjunto de devoluciones de llamada registradas.
- Si no se está ejecutando ninguna devolución de llamada para ese token de devolución de llamada, la llamada devuelve true.
- Si se están ejecutando devoluciones de llamada y wait es true, la llamada se bloquea hasta que la devolución de llamada en ejecución haya finalizado.
- Si se están ejecutando devoluciones de llamada y wait es false, la llamada no se bloquea pero devuelve false. Cuando la devolución de llamada del token se completa, el registro del token se anula automáticamente.
No se debe llamar a esta función desde dentro de una XNetworkingConnectivityHintChangedCallback si wait es true, ya que esto provocará un interbloqueo.
- Puede bloquearse en la anulación del registro para asegurarse de que sus devoluciones de llamada nunca se invoquen después de una llamada de anulación del registro.
- Puede optar por no bloquearse. Si necesita asegurarse de que sus devoluciones de llamada se completen antes de eliminar datos, puede llamar periódicamente a esta función con wait establecido en false. Cuando finalmente devuelva true, todas sus devoluciones de llamada se habrán completado y podrá eliminar el estado.
- Si a su devolución de llamada no le importa si se invoca durante una llamada de anulación del registro, puede pasar false para wait y omitir el valor devuelto.
Requisitos
Encabezado: XNetworking.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX SeriesDocumentación conceptual
Consulte también
XNetworkingRegisterConnectivityHintChangedXNetworkingGetConnectivityHint
Inicialización de red y conectividad
XNetworking