Documentation
(C) IBM Corp. 1996, 2000

DB2 Text Extender
°ü¸® ¹× ÇÁ·Î±×·¡¹Ö

DesGetMatches

¸ñÀû

¹®¼­ Çڵ鿡 ÀÇÇØ ¼³¸íµÈ ÅØ½ºÆ® ¹®¼­¿¡ ´ëÇÑ °­Á¶Ç¥½Ã Á¤º¸¸¦ Æ÷ÇÔÇÏ´Â µ¥ÀÌÅÍ ½ºÆ®¸²À» ¸®ÅÏÇÕ´Ï´Ù. µ¥ÀÌÅÍ ½ºÆ®¸² ±¸¹®À» Âü°íÇϽʽÿÀ. °­Á¶Ç¥½Ã Á¤º¸´Â ÅØ½ºÆ® ¹®¸Æ(ÃÖ¼ÒÇÑ ÇϳªÀÇ ¹®´Ü)°ú ±× ¹®¸Æ¿¡ ÀÖ´Â °­Á¶Ç¥½Ã ÅØ½ºÆ®¿¡ ´ëÇÑ Á¤º¸¸¦ Æ÷ÇÔÇÕ´Ï´Ù.

DesGetMatches´Â Ãâ·Â ±¸Á¶¿¡ ÀÖ´Â ºÎºÐÀÇ ±æÀ̸¦ Ç¥½ÃÇÏ´Â µ¥ÀÌÅÍ ½ºÆ®¸²ÀÇ ºÎºÐ¸¸ ¸®ÅÏÇÕ´Ï´Ù.

DesGetMatches¿¡ ´ëÇÑ È£Ãâ ¼ø¼­´Â Àüü ÅØ½ºÆ® ¹®¼­ ³»¿ëÀ» È®º¸ÇÕ´Ï´Ù. ÅØ½ºÆ® ¹®¼­ÀÇ ³¡¿¡ µµ´ÞÇϸé, RC_SE_END_OF_INFORMATIONÀÌ ¸®Åϵ˴ϴÙ.

±¸¹®

DESRETURN
  DesGetMatches
     (DESBROWSESESSION    BrowseSession,
      DESHANDLE           DocumentHandle,
      DESMATCHINFO        *pMatchInfo,
      DESULONG            *pMatchInfoLength,
      DESMESSAGE           *pErrorMessage);

ÇÔ¼ö Àμö

Ç¥ 13. DesGetMatches Àμö
µ¥ÀÌÅÍ À¯Çü Àμö »ç¿ë ¼³¸í
DESBROWSESESSION BrowseSession ÀÔ·Â ¿­¶÷ ¼¼¼Ç ÇÚµéÀÔ´Ï´Ù.
DESHANDLE DocumentHandle ÀÔ·Â DesOpenDocument¿¡ ÀÇÇØ ¸®ÅÏµÈ ¹®¼­ ÇÚµéÀÔ´Ï´Ù.
DESMATCHINFO * pMatchInfo Ãâ·Â ¼ö½ÅµÈ µ¥ÀÌÅÍ ½ºÆ®¸² ºÎºÐÀ» Æ÷ÇÔÇÏ´Â ¹öÆÛ¿¡ ´ëÇÑ Æ÷ÀÎÅÍÀÔ´Ï´Ù. DesGetMatches´Â ±× ¹öÆÛ¸¦ ÇÒ´çÇÕ´Ï´Ù.
DESULONG * pMatchInfoLength Ãâ·Â pMatchInfo°¡ Áö½ÃÇÏ´Â, µ¥ÀÌÅÍ ½ºÆ®¸² ºÎºÐÀÇ ±æÀÌ.
DESMESSAGE * pErrorMessage Ãâ·Â ±¸Çö Á¤ÀÇ ¸Þ½ÃÁö ÅØ½ºÆ®. ¿À·ù°¡ ¹ß»ýÇÏ´Â °æ¿ì, DB2 Text Extender´Â ¿À·ù ÄÚµå¿Í ¿À·ù ¸Þ½ÃÁö¸¦ ¸®ÅÏÇÕ´Ï´Ù. ÀÀ¿ëÇÁ·Î±×·¥ÀÌ DES_MAX_MESSAGE_LENGTH Å©±âÀÇ ¹öÆÛ¸¦ ÇÒ´çÇÕ´Ï´Ù. pErrorMessage°¡ ³Î(NULL) Æ÷ÀÎÅÍÀ̸é, ¿À·ù ¸Þ½ÃÁö´Â ¸®ÅϵÇÁö ¾Ê½À´Ï´Ù.

µ¥ÀÌÅÍ ½ºÆ®¸² ±¸¹®

>>- --05-- --DB2TX_DOC-- --DB2TX_START-- ----------------------->
 
>-----+-------------------------------------------------------------+>
      '- --ll-- --DB2TX_DNAM-- --DB2TX_ATOMIC-- --document_name-- --'
 
      .----------------.
      V                |
>--------| Section |---+-- --05-- --DB2TX_DOC-- --DB2TX_END-- --><
 
Section
 
|--- --05-- --DB2TX_DEL-- --DB2TX_START-- ---------------------->
 
>-----+------------------------------------------------------------+>
      '- --ll-- --DB2TX_SNAM-- --DB2TX_ATOMIC-- --section_name-- --'
 
      .-------------------------------------------.
      |                     .------------------.  |
      V                     V                  |  |
>--------| Text encoding |-----| Paragraph |---+--+------------->
 
>---- --05-- --DB2TX_DEL-- --DB2TX_END-- -----------------------|
 
Text encoding
 
|--- --07-- --DB2TX_CCSID-- --DB2TX_ATOMIC-- --coded_character_set_identifier-- -->
 
>--- --07-- --DB2TX_LANG-- --DB2TX_ATOMIC-- --language_identifier-- -->
 
>---------------------------------------------------------------|
 
Paragraph
 
|--- --05-- --DB2TX_PAR-- --DB2TX_START-- ---------------------->
 
      .-----------------------.
      V                       |
>--------| Paragraph text |---+--------------------------------->
 
>---- --05-- --DB2TX_PAR-- --DB2TX_END-- -----------------------|
 
Paragraph text
 
|---+- --ll-- --DB2TX_TEXT-- --DB2TX_ATOMIC-- --text_unit-- --+->
    '- --ll-- --DB2TX_LINK-- --DB2TX_ATOMIC-- --media_ref-- --'
 
      .-----------------------------------------------.
      V                                               |
>--------+-----------------------------------------+--+--------->
         '- --05-- --DB2TX_NL-- --DB2TX_ATOMIC-- --'
 
      .------------------------------------------------------------------------.
      V                                                                        |
>--------+------------------------------------------------------------------+--+>
         '- --ll-- --DB2TX_MATCH-- --DB2TX_ATOMIC-- --match_information-- --'
 
>---------------------------------------------------------------|
 

 

05 DB2TX_DOC DB2TX_START¿Í °°Àº ±¸¹® µµÇ¥¿¡ ÀÖ´Â °¢ ¼¼±×¸ÕÆ®´Â Á¤¼ö À¯ÇüÀÇ ±æÀÌ Çʵå·Î ½ÃÀÛÇÕ´Ï´Ù. µµÇ¥¿¡¼­ ÀÌ Çʵå´Â 05¿Í °°Àº ¸í½ÃÀû ¼ýÀÚÀ̰ųª ll°ú °°Àº º¯¼öÀÔ´Ï´Ù. ¼¼±×¸ÕÆ®ÀÇ ±æÀÌ´Â 2¹ÙÀÌÆ® ±æÀÌ Çʵ带 Æ÷ÇÔÇÕ´Ï´Ù.
ÁÖ:±æÀÌ´Â big-endian Çü½ÄÀÔ´Ï´Ù.

°¢°¢ÀÇ ¼¼±×¸ÕÆ®´Â ´ÙÀ½°ú °°Àº 1¹ÙÀÌÆ® À¯Çü ½Äº°ÀÚ Áß Çϳª¸¦ Æ÷ÇÔÇÕ´Ï´Ù.

DB2TX_START
¹®¼­ ¶Ç´Â ¹®´Ü°ú °°Àº ¼¼±×¸ÕÆ®ÀÇ ½ÃÀÛÀ» ³ªÅ¸³À´Ï´Ù.

DB2TX_END
¼¼±×¸ÕÆ®ÀÇ ³¡À» ³ªÅ¸³À´Ï´Ù.

DB2TX_ATOMIC
ÈļÓÇÏ´Â Ç׸ñÀÌ ¹®¼­ À̸§À̳ª ¾ð¾î ½Äº°ÀÚ¿Í °°ÀÌ ÃÖ¼Ò ´ÜÀ§ÀÓÀ» ³ªÅ¸³À´Ï´Ù.

µ¥ÀÌÅÍ ½ºÆ®¸² Ç׸ñÀº °¢°¢ µÎ ¹ÙÀÌÆ® ±æÀÌÀÔ´Ï´Ù. ÀÌ·¯ÇÑ Ç׸ñÀº ´ÙÀ½°ú °°½À´Ï´Ù.

DB2TX_DOC
¹®¼­ÀÇ ½ÃÀÛ°ú ³¡À» ³ªÅ¸³À´Ï´Ù.

DB2TX_DNAM
¹®¼­ À̸§ÀÔ´Ï´Ù. À̸§ÀÌ ÁöÁ¤µÇÁö ¾ÊÀ¸¸é, ¹®¼­ÀÇ ½Äº°ÀÚ°¡ »ç¿ëµË´Ï´Ù.

DB2TX_DEL
¹®¼­ ¿ä¼ÒÀÇ ½ÃÀÛ°ú ³¡À» ³ªÅ¸³À´Ï´Ù. ÇöÀç Áö¿øµÈ ¹®¼­ ¿ä¼ÒÀÇ À¯ÀÏÇÑ À¯ÇüÀº ÅØ½ºÆ® ¼½¼ÇÀÔ´Ï´Ù.

DB2TX_SNAM
ÅØ½ºÆ® ¼½¼ÇÀÇ À̸§À» ÁöÁ¤ÇÕ´Ï´Ù. ÇöÀç, DB2 Text Extender´Â ÇϳªÀÇ ÅØ½ºÆ® ¼½¼Ç¸¸ Áö¿øÇϰí, ÀÚµ¿À¸·Î ±âº»°ª À̸§À» Áö¿øÇÕ´Ï´Ù. ¼½¼ÇÀÇ À̸§À» ÁöÁ¤ÇÑ´Ù ÇØµµ ±×°ÍÀº ¹«½ÃµË´Ï´Ù.

DB2TX_PAR
ÇöÀç ¼½¼Ç ¾È¿¡ ÀÖ´Â ÅØ½ºÆ® ¹®´ÜÀÇ ½ÃÀÛ°ú ³¡À» ³ªÅ¸³À´Ï´Ù.

DB2TX_TEXT
ÇöÀç ¹®´Ü¿¡ ÀÖ´Â ÇϳªÀÇ ÅØ½ºÆ® ºÎºÐÀ» ÁöÁ¤ÇÕ´Ï´Ù. ÁÖ·Î, ÅØ½ºÆ® ´ÜÀ§¿¡´Â ÇϳªÀÇ ÅØ½ºÆ® ÇàÀÌ Æ÷ÇԵǸç, TEXT Ç׸ñ ´ÙÀ½¿¡´Â DB2TX_NL Ç׸ñÀÌ ¿É´Ï´Ù. ´Ü, ÅØ½ºÆ® ÇàÀº °¢ ºÎºÐÀÌ °íÀ¯ÀÇ DB2TX_TEXT Ç׸ñ¿¡ ÁöÁ¤µÇ´Â ¿©·¯ °³ÀÇ ºÎºÐÀ¸·Î ºÐ¸®µÉ ¼öµµ ÀÖ½À´Ï´Ù.

ÅØ½ºÆ®´Â CCSID ¹× ÇöÀç ¹®´Ü°ú °ü·ÃµÈ ¾ð¾î¸¦ »ç¿ëÇÕ´Ï´Ù.

DB2TX_LINK
DB2 Text Extender ÇÏÀÌÆÛ¹Ìµð¾î ÂüÁ¶¸¦ ÁöÁ¤ÇÕ´Ï´Ù. À̰ÍÀº ÇöÀç ¹®´ÜÀÇ CCSID¸¦ »ç¿ëÇÕ´Ï´Ù.

DB2TX_NL
ÇöÀç ¹®´Ü¿¡¼­ »õ·Î¿î ÇàÀÇ ½ÃÀÛÀ» ³ªÅ¸³À´Ï´Ù.

DB2TX_MATCH
ÇöÀç ÅØ½ºÆ® ºÎºÐ¿¡¼­ ÀÏÄ¡¿¡ ´ëÇÑ ¹ß»ý Á¤º¸¸¦ Æ÷ÇÔÇÕ´Ï´Ù. Á¤º¸´Â 2Áø¼ö ½ÖÀÇ ¼ø¼­·Î Á¦°øµË´Ï´Ù. °¢°¢ÀÇ ½Ö¿¡¼­ ù¹øÂ° ¼ö´Â ÇöÀç ÅØ½ºÆ® ºÎºÐ¿¡ ÀÖ´Â ÀÏÄ¡ÀÇ ¿ÀÇÁ¼ÂÀÌ°í µÎ¹øÂ° ¼ö´Â ¹®ÀÚ¿¡¼­ ±× ÀÏÄ¡ÀÇ ±æÀÌÀÔ´Ï´Ù. ÁÖ¾îÁø ±æÀÌ´Â ÁÖ¾îÁø ÅØ½ºÆ® ºÎºÐÀ» ÃʰúÇÒ ¼ö ÀÖ½À´Ï´Ù. ¿ÀÇÁ¼Â°ú ±æÀÌ´Â ¸ðµÎ big-endian Çü½ÄÀ¸·Î ÁöÁ¤µÈ 2¹ÙÀÌÆ® °ªÀÔ´Ï´Ù.

DB2TX_CCSID
¹®´Ü ¾Õ¿¡ »õ·Î¿î DB2TX_CCSID Ç׸ñÀÌ ¿Ã ¶§±îÁö ÈÄ¼Ó ¹®´Ü¿¡ ÀÖ´Â ÅØ½ºÆ®¿¡ ´ëÇÑ CCSIDÀÔ´Ï´Ù. ´ÙÀ½°ú °°Àº CCSID°¡ ¸®Åϵ˴ϴÙ.

DB2TX_CCSID_00500
¶óƾ-1 EBCDIC ÄÚµå ÆäÀÌÁö 500ÀÇ ÅØ½ºÆ®¿ë.

DB2TX_CCSID_04946
¶óƾ-1 ASCII ÄÚµå ÆäÀÌÁö 850ÀÇ ÅØ½ºÆ®¿ë.

DB2TX_CCSID_00819
ASCII ÄÚµå ÆäÀÌÁö 819ÀÇ ÅØ½ºÆ®¿ë.

CCSID¿¡ ´ëÇÑ ÀÌ ±âÈ£ À̸§Àº DB2 Text Extender¿¡¼­ Á¦°øÇÏ´Â DES_EXT.H ÆÄÀÏ¿¡ Á¤Àǵ˴ϴÙ. 2¹ÙÀÌÆ® 2Áø °ªÀÌ big-endian Çü½ÄÀ¸·Î ÁöÁ¤µË´Ï´Ù.

DB2TX_LANG
¹®´Ü ¾Õ¿¡ »õ·Î¿î DB2TX_LANG Ç׸ñÀÌ ¿Ã ¶§±îÁö ÈÄ¼Ó ¹®´Ü¿¡ ÀÖ´Â ÅØ½ºÆ®¿¡ ´ëÇÑ ¾ð¾î ½Äº°ÀÚÀÔ´Ï´Ù. DB2 Text Extender¿¡¼­ Á¦°øÇÏ´Â DES_EXT.H ÆÄÀÏÀÌ DB2 Text Extender¿¡¼­ Áö¿øÇÏ´Â ¸ðµç ¾ð¾î ½Äº°ÀÚÀÇ ±âÈ£¸íÀ» Á¤ÀÇÇÕ´Ï´Ù. 2¹ÙÀÌÆ® 2Áø °ªÀÌ big-endian Çü½ÄÀ¸·Î ÁöÁ¤µË´Ï´Ù.

»ç¿ë¹ý

DesGetMatches´Â ÅØ½ºÆ® ¹®¼­ÀÇ ³¡¿¡ µµ´ÞÇÒ ¶§ RC_SE_END_OF_INFORMATIONÀ» ¸®ÅÏÇÕ´Ï´Ù.

¸®ÅÏ ÄÚµå

RC_SUCCESS
RC_SE_END_OF_INFORMATION
 
RC_INVALID_PARAMETER
RC_INVALID_SESSION
RC_SE_CAPACITY_LIMIT_EXCEEDED
RC_SE_INCORRECT_HANDLE
RC_SE_IO_PROBLEM
RC_SE_NOT_ENOUGH_MEMORY
RC_SE_REQUEST_IN_PROGRESS
RC_SE_LS_FUNCTION_FAILED
RC_SE_UNEXPECTED_ERROR
 
°æ°í: ´ÙÀ½°ú °°Àº ¸®ÅÏ ÄÚµå´Â, ÇÔ¼ö°¡ °á°ú¸¦ ¸®ÅÏÇÏ¿´Áö¸¸ ±× °á°ú´Â ¿¹»ó°ú ´Ù¸¦ ¼öµµ ÀÖ´Ù´Â °ÍÀ» ³ªÅ¸³À´Ï´Ù.
 
RC_SE_DICTIONARY_NOT_FOUND

Á¦ÇÑ»çÇ×

ÀÌ ÇÔ¼ö´Â DesOpenDocument¸¦ È£ÃâÇÏ¿© ÅØ½ºÆ® ¹®¼­¸¦ ¿¬ ´ÙÀ½¿¡¸¸ È£ÃâµÉ ¼ö ÀÖ½À´Ï´Ù.


[ ÆäÀÌÁöÀÇ ¸Ç À§ | ÀÌÀü ÆäÀÌÁö | ´ÙÀ½ ÆäÀÌÁö | ¸ñÂ÷ | »öÀÎ ]