目的地是應用程式送出訊息所在,或是應用程式從中收到訊息的來源(或兩者)。
有關 XMS 所定義的 Destination 物件內容清單, 請參閱Destination 內容。
函數 | 說明 |
---|---|
xmsDestCreate | 使用指定的統一資源識別碼 (URI) 來建立目的地。 |
xmsDestCreateByType | 使用指定的目的地類型和名稱來建立目的地。 |
xmsDestCreateTemporaryByType | 建立暫時目的地。 |
xmsDestDispose | 刪除目的地。 |
xmsDestGetName | 取得目的地的名稱。 |
xmsDestGetTypeId | 取得目的地的類型。 |
xmsDestToString | 取得採用統一資源識別碼 (URI) 格式的目的地名稱。 |
xmsRC xmsDestCreate(xmsCHAR *URI, xmsHDest *destination, xmsHErrorBlock errorBlock);
使用指定的統一資源識別碼 (URI) 來建立目的地。若未使用 URI 來指定目的地內容, 則會採用預設值。
如果目的地是一個佇列, 則這個函數不會在傳訊伺服器中建立佇列。您必須先建立佇列,應用程式才能呼叫這個函數。
xmsRC xmsDestCreateByType(xmsDESTINATION_TYPE destinationType, xmsCHAR *destinationName, xmsHDest *destination, xmsHErrorBlock errorBlock);
如果目的地是一個佇列, 則這個函數不會在傳訊伺服器中建立佇列。您必須先建立佇列,應用程式才能呼叫這個函數。
xmsRC xmsDestCreateTemporaryByType(xmsDESTINATION_TYPE destinationType, xmsHSess session, xmsHDest *destination, xmsHErrorBlock errorBlock);
暫時目的地的範圍為連線。只有連線所建立的階段作業才能使用暫時目的地。
除非明確刪除或連線結束(看何者較快發生), 暫時目的地會一直存在。
如需暫時目的地的相關資訊,請參閱暫時目的地。
xmsRC xmsDestGetName(xmsHDest destination, xmsCHAR *destinationName, xmsINT length, xmsINT *actualLength, xmsHErrorBlock errorBlock);
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 C 函數。
xmsRC xmsDestGetTypeId(xmsHDest destination, xmsDESTINATION_TYPE *destinationType, xmsHErrorBlock errorBlock);
xmsRC xmsDestToString(xmsHDest destination, xmsCHAR *destinationName, xmsINT length, xmsINT *actualLength, xmsHErrorBlock errorBlock);
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 C 函數。