<html>
<head>
<base href="https://wiki.asterisk.org/wiki">
<link rel="stylesheet" href="/wiki/s/en/2171/18/9/_/styles/combined.css?spaceKey=AST&forWysiwyg=true" type="text/css">
</head>
<body style="background: white;" bgcolor="white" class="email-body">
<div id="pageContent">
<div id="notificationFormat">
<div class="wiki-content">
<div class="email">
<h2><a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Function_SMDI_MSG_RETRIEVE">Asterisk 10 Function_SMDI_MSG_RETRIEVE</a></h2>
<h4>Page <b>added</b> by <a href="https://wiki.asterisk.org/wiki/display/~wikibot">Wiki Bot</a>
</h4>
<br/>
<div class="notificationGreySide">
<h1><a name="Asterisk10Function_SMDI_MSG_RETRIEVE-SMDIMSGRETRIEVE%28%29"></a>SMDI_MSG_RETRIEVE()</h1>
<h3><a name="Asterisk10Function_SMDI_MSG_RETRIEVE-Synopsis"></a>Synopsis</h3>
<p>Retrieve an SMDI message.</p>
<h3><a name="Asterisk10Function_SMDI_MSG_RETRIEVE-Description"></a>Description</h3>
<p>This function is used to retrieve an incoming SMDI message. It returns an ID which can be used with the SMDI_MSG() function to access details of the message. Note that this is a destructive function in the sense that once an SMDI message is retrieved using this function, it is no longer in the global SMDI message queue, and can not be accessed by any other Asterisk channels. The timeout for this function is optional, and the default is 3 seconds. When providing a timeout, it should be in milliseconds. </p>
<p>The default search is done on the forwarding station ID. However, if you set one of the search key options in the options field, you can change this behavior.</p>
<h3><a name="Asterisk10Function_SMDI_MSG_RETRIEVE-Syntax"></a>Syntax</h3>
<div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent">
<pre>SMDI_MSG_RETRIEVE(smdi port,search key[,timeout[,options]])</pre>
</div></div>
<h5><a name="Asterisk10Function_SMDI_MSG_RETRIEVE-Arguments"></a>Arguments</h5>
<ul>
<li><tt>smdi port</tt></li>
<li><tt>search key</tt></li>
<li><tt>timeout</tt></li>
<li><tt>options</tt>
<ul>
<li><tt>t</tt> - Instead of searching on the forwarding station, search on the message desk terminal.</li>
<li><tt>n</tt> - Instead of searching on the forwarding station, search on the message desk number.</li>
</ul>
</li>
</ul>
<h3><a name="Asterisk10Function_SMDI_MSG_RETRIEVE-SeeAlso"></a>See Also</h3>
<p><a href="/wiki/pages/createpage.action?spaceKey=AST&title=Asterisk+10+Function_SMDI_MSG&linkCreation=true&fromPageId=19006105" class="createlink">Asterisk 10 Function_SMDI_MSG</a></p>
<h3><a name="Asterisk10Function_SMDI_MSG_RETRIEVE-ImportVersion"></a>Import Version</h3>
<p>This documentation was imported from Asterisk version SVN-branch-10-r340810.</p>
</div>
<div id="commentsSection" class="wiki-content pageSection">
<div style="float: right;" class="grey">
<a href="https://wiki.asterisk.org/wiki/users/removespacenotification.action?spaceKey=AST">Stop watching space</a>
<span style="padding: 0px 5px;">|</span>
<a href="https://wiki.asterisk.org/wiki/users/editmyemailsettings.action">Change email notification preferences</a>
</div>
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Function_SMDI_MSG_RETRIEVE">View Online</a>
|
<a href="https://wiki.asterisk.org/wiki/display/AST/Asterisk+10+Function_SMDI_MSG_RETRIEVE?showComments=true&showCommentArea=true#addcomment">Add Comment</a>
</div>
</div>
</div>
</div>
</div>
</body>
</html>