cniSetAttribute

Questa funzione imposta il valore di un attributo su una determinata istanza del nodo. Viene richiamata dal broker di messaggi quando viene ricevuta una richiesta di configurazione che tenta di impostare il valore di un attributo del nodo oppure durante l'inizializzazione del nodo. Un nodo riceve le richieste di impostare gli attributi per la base. Se viene ricevuto un valore di attributo sconosciuto, questa funzione deve restituire una valore diverso da zero in modo che il broker elabora la richiesta correttamente.

Il nodo a questo punto deve eseguire quando riportato di seguito:
  1. Verificare che il valore dell'attributo sia specificato correttamente. Altrimenti, deve essere generata un'eccezione di configurazione utilizzando la funzione cciThrowException.
  2. Memorizzare il valore dell'attributo all'interno del contesto, che deve essere assegnato nella funzione cniCreateNodeContext.
  3. Generare un'eccezione di configurazione se si verifica un'errore, utilizzando la funzione cciThrowException.
Definito in Tipo Membro
CNI_VFT Facoltativo iFpSetAttribute

Sintassi

int cniSetAttribute(
  CciContext*  context,
  CciChar*     attrName,
  CciChar*     attrValue);

Parametri

context
L'indirizzo del contesto per l'istanza del nodo, come creato dal nodo e restituito dalla funzione cniCreateNodeContext (input).
attrName
Il nome dell'attributo per il quale deve essere impostato il valore (input).
attrValue
Il valore dell'attributo (input).

Valori di restituzione

Se ha esito positivo, viene restituito il valore zero. Se il nome dell'attributo non ne identifica uno supportato dal nodo, viene restituito un valore diverso da zero.

Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as07490_