Condividi tramite

Uso del moniker coda

  • Articolo

Il moniker della coda viene usato per attivare un componente in coda a livello di codice. Il moniker della coda richiede che riceva l'ID classe (CLSID) dell'oggetto da richiamare direttamente dal nuovo moniker a destra di esso. Se preceduto da sinistra, il nuovo moniker passa il CLSID al moniker a sinistra.

Strumento di Amministrazione istrative di Servizi componenti

Non è valida.

Visual Basic

Il parametro del nome visualizzato GetObject è "queue:/new:", seguito dall'ID programma o dal GUID in formato stringa, con o senza parentesi graffe, dell'oggetto server di cui creare un'istanza. Gli esempi seguenti mostrano tre attivazioni valide di un componente con il moniker della coda:

  1. Set objMyQC = GetObject ("queue:/new:QCShip.Ship")

  2. Set objMyQC = GetObject ("queue:/new:{812DF40E-BD88-11D0-8A6D-00C04FC340EE}")

  3. Set objMyQC = GetObject ("queue:/new:812DF40E-BD88-11D0-8A6D-00C04FC340EE")

C/C++

Il parametro del nome visualizzato CoGetObject è "queue:/new:", seguito dall'ID programma o dal GUID in formato stringa, con o senza parentesi graffe, dell'oggetto server di cui creare un'istanza. Gli esempi seguenti mostrano tre attivazioni valide di un componente con il moniker della coda:

  1. hr = CoGetObject (
  L"queue:/new:QCShip.Ship",
  NULL, IID_IShip, (void**)&pShip);

  2. hr = CoGetObject (
  L"queue:/new:{812DF40E-BD88-11D0-8A6D-00C04FC340EE}", 
  NULL, IID_IShip, (void**)&pShip);

  3. hr = CoGetObject (
  L"queue:/new:812DF40E-BD88-11D0-8A6D-00C04FC340EE",
  NULL, IID_IShip, (void**)&pShip);

Osservazioni:

Il moniker della coda accetta parametri facoltativi che modificano le proprietà del messaggio inviato a Accodamento messaggi. Ad esempio, per fare in modo che il messaggio di accodamento messaggi venga inviato con una priorità 6, il componente in coda verrà attivato come segue:

hr = CoGetObject (
  L"queue:Priority=6,ComputerName=MyComp/new:QCShip.Ship",
  NULL, IID_IShip, (void**)&pShip);

Nella tabella seguente sono elencati i parametri del moniker della coda che influiscono sulla coda di destinazione.

Parametro Descrizione
NomeComputer
 Specifica la parte del nome computer di un nome di percorso della coda di accodamento messaggi. Il nome del percorso della coda di accodamento messaggi è formattato come NomeComputer<em>QueueName. Se non specificato, viene usato il nome del computer associato all'applicazione configurata.
QueueName
 Specifica il nome della coda di accodamento messaggi. Il nome del percorso della coda di accodamento messaggi è formattato come NomeComputer<em>QueueName. Se non specificato, viene usato il nome della coda associato all'applicazione configurata.
Per ottenere una coda non transazionale, è possibile specificare innanzitutto il nome della coda e quindi creare un'applicazione COM+ con lo stesso nome.
PathName
 Specifica il nome completo del percorso della coda di accodamento messaggi. Se non specificato, viene usato il nome del percorso della coda di accodamento messaggi associato all'applicazione configurata. Per eseguire l'override del nome di destinazione, è possibile specificare il percorso nel formato seguente per un'installazione del gruppo di lavoro accodamento messaggi:
Queue:PathName ComputerName=\PRIVATE$\AppName/new:Myproject.CMyClass
Nota: entrambi i linguaggi di programmazione C e Microsoft Visual C++ richiedono due barre rovesciata per rappresentare una barra rovesciata all'interno di valori letterali stringa, ad esempio chicago\payroll.
Formatname
 Quando si contrassegna un'applicazione COM+ come in coda, COM+ crea una coda di accodamento messaggi il cui nome corrisponde all'applicazione. Il nome del formato di accodamento messaggi della coda si trova nel catalogo COM+, associato all'applicazione COM+. Per eseguire l'override del nome di destinazione, è possibile specificare il nome del formato nel formato seguente per un'installazione del gruppo di lavoro accodamento messaggi:
Queue:FormatName=DIRECT=OS:ComputerName\PRIVATE$\AppName/new:ProgId
In una configurazione di Active Directory, "PRIVATE$" non viene specificato come parte del nome della coda.

Nota

I parametri del moniker della coda facoltativi vengono elaborati da sinistra a destra. Specificare ogni parola chiave una sola volta. Se si specifica il parametro PathName , i parametri ComputerName e QueueNamevengono sostituiti. Un parametro FormatName specifico elimina le conoscenze precedenti di un parametro ComputerName, QueueName e PathName.

Associazione del listener dei componenti in coda a una coda privata specifica

Il listener COM+ Queued Components riceve solo dalle code associate all'applicazione COM+ contrassegnata in coda. Quando si contrassegna un'applicazione COM+ come in coda, COM+ crea una coda di accodamento messaggi il cui nome corrisponde all'applicazione. Il nome del formato di accodamento messaggi della coda si trova nel catalogo COM+, associato all'applicazione COM+. Quando l'applicazione COM+ viene avviata e contrassegnata come listener, viene avviato un listener nel processo dell'applicazione COM+ e la coda viene aperta. Nella tabella seguente sono elencati i parametri del moniker della coda che influiscono sul messaggio di accodamento messaggi.

Parametro Descrizione
AppSpecific
 Specifica un intero senza segno, ad esempio AppSpecific=12345.
AuthLevel
 Specifica il livello di autenticazione del messaggio. Un messaggio autenticato è firmato digitalmente e richiede un certificato per l'utente che invia il messaggio. Valori accettabili:
  • MQMSG_AUTH_LEVEL_NONE,0
  • MQMSG_AUTH_LEVEL_ALWAYS,1
Recapito
 Specifica l'opzione di recapito dei messaggi. Questo valore viene ignorato per le code transazionali. Valori accettabili:
  • MQMSG_DELIVERY_EXPRESS,0
  • MQMSG_DELIVERY_RECOVERABLE,1
EncryptAlgorithm
 Specifica l'algoritmo di crittografia da utilizzare da Accodamento messaggi per crittografare e decrittografare il messaggio. Valori accettabili:
  • CALG_RC2, CALG_RC4
  • Qualsiasi valore intero accettabile per Accodamento messaggi per EncryptAlgorithm.
Hashalgorithm
 Specifica una funzione hash crittografica. Valori accettabili:
  • CALG_MD2, CALG_MD4, CALG_MD5, CALG_SHA, CALG_SHA1, CALG_MAC, CALG_SSL3_SHAMD5, CALG_HMAC, CALG_TLS1PRF
  • Qualsiasi valore intero accettabile per Accodamento messaggi per hashAlgorithm.
Giornale di registrazione
 Specifica l'opzione Message Queuing Message Journal . Valori accettabili:
  • MQMSG_JOURNAL_NONE,0
  • MQMSG_DEADLETTER,1
  • MQMSG_JOURNAL,2
Etichetta
 Specifica una stringa di etichetta del messaggio fino a MQ_MAX_MSG_LABEL_LEN caratteri.
MaxTimeToReachQueue
 Specifica un tempo massimo, espresso in secondi, affinché il messaggio raggiunga la coda.
Valori accettabili:
  • INFINITE
  • LONG_LIVED
  • Numero di secondi
MaxTimeToReceive
 Specifica un tempo massimo, espresso in secondi, per la ricezione del messaggio dall'applicazione di destinazione. Valori accettabili:
  • INFINITE
  • LONG_LIVED
  • Numero di secondi
Priorità
 Specifica un livello di priorità del messaggio, all'interno dei valori di Accodamento messaggi consentiti.
Valori accettabili:
  • MQ_MIN_PRIORITY,0
  • MQ_MAX_PRIORITY,7
  • MQ_DEFAULT_PRIORITY,3
  • Numero compreso tra 0 e 7
PrivLevel
 Specifica un livello di privacy, usato per crittografare i messaggi.
Valori accettabili:
  • MQMSG_PRIV_LEVEL_NONE, NONE, 0
  • MQMSG_PRIV_LEVEL_BODY, BODY,
  • MQMSG_PRIV_LEVEL_BODY_BAedizione Standard, BODY_BAedizione Standard, 1
  • MQMSG_PRIV_LEVEL_BODY_ENHANCED, BODY_ENHANCED, 3
Traccia
 Specifica le opzioni di traccia utilizzate per tracciare il routing di Accodamento messaggi.
Valori accettabili:
  • MQMSG_TRACE_NONE,0
  • MQMSG_edizione StandardND_ROUTE_TO_REPORT_QUEUE,1

Il set completo di funzioni COM+ Amministrazione istrative SDK è disponibile tramite oggetti COM. Ciò consente a qualsiasi programma di avviare e arrestare le applicazioni COM+ in base alle esigenze.

Nota

Quando viene avviata un'applicazione COM+, si tratta dell'applicazione in esecuzione, non dei singoli componenti all'interno dell'applicazione. Se un'applicazione chiama un componente non in coda, viene avviata l'applicazione COM+ che contiene il componente. Se la casella di controllo del listener è abilitata, il listener avvia e avvia anche l'elaborazione dei messaggi per i componenti in coda. Anche se il servizio componenti in coda può essere avviato in questo modo, se si inseriscono componenti in coda e non in coda in una singola applicazione COM+, assicurarsi di voler avviare i componenti in coda se viene eseguito un componente non in coda. In caso contrario, creare un pacchetto dei componenti in coda in un'applicazione COM+ separata dagli altri componenti.

Attivazione delle code dei componenti